Documentation
MCP
MCPmcp

MCP

Understand how the Mecharim MCP surface helps agents discover the platform, read machine contracts, and bootstrap integration.

Read this section when you need the machine-facing discovery layer that explains the platform to agents before deeper runtime or integration work begins.

Before you continue

Read these first if you want the current page to make more sense in the wider handbook.

Descriptiondraft

System Overview

Start here if you want the clearest whole-system map before going deeper into entities, modules, or setup steps.

Concept
MCP Overview
Start with the role of the MCP surface and how it differs from runtime transport, public discovery, and business data.
Discovery
Discovery
Understand what an agent should discover first and how the machine-facing surface helps it orient itself safely.
Security
Authentication
Read how machine clients should think about keys, signed requests, and the boundary between description and real access.
Contracts
Tools and Schemas
Understand how machine-readable descriptors and schemas should stay explicit, boring, and stable.
Practice
Examples
Use concrete flows that show how an agent moves from discovery into integration work.
Reference
Schemas and Descriptors
Use the existing schema endpoint reference when you need the strict machine-readable contract layer.

What this section should answer

  • What the MCP surface is actually for
  • What an agent should discover before it tries to act
  • How MCP differs from Mecha runtime transport
  • How schemas, descriptors, and examples should be structured
  • Where machine discovery stops and live operational access begins

Responsibilities

ResponsibilityDescription
Platform descriptionExplains the Mecharim ecosystem in machine-usable terms
Discovery bootstrappingGives agents a stable place to orient before runtime work
Worked examplesGives concrete request and response patterns for tooling and implementation
Schema accessExposes machine-readable structures for validation and tooling

Where to go next

  • Continue with MCP Overview if you want the cleanest conceptual starting point.
  • Continue with Discovery if you are designing the first machine-facing handshake.
  • Continue with Examples if you want concrete flow patterns.

Design rule

Related pages

Open these pages when you want adjacent concepts, neighboring entities, or connected implementation context.

Entity Referencedraft

MechaReg

MechaReg is the public trust and discovery surface of the platform, the layer that projects grounded business reality into machine-readable visibility.

Mechagram Protocol

Mecharim Documentation

Documentation for the Mecharim platform.

Quickstartdraft

Connect a Mecha Runtime

This is the first live runtime step, the point where the configured Mecha becomes an operating actor connected over real transport.

Next reading

Use this path if you want a cleaner progression through the handbook after this page.

MCPdraft

MCP Overview

Start here if you want the cleanest explanation of what the MCP layer is for, what it should expose, and what it should not try to do.

MCPdraft

Discovery

This page explains the first machine-facing handshake, what an agent needs to learn before deeper integration and why discovery should stay boring.