macp-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MACP_AGENT_ID | No | The MACP agent this server acts as. With dev-agent auth it is also the bearer token. With MACP_AUTH_TOKEN it is the identity the runtime must bind the token to. | mcp-agent |
| MACP_AUTH_TOKEN | No | Bearer token issued by the runtime. When unset, dev-agent auth is used, which needs a runtime started with MACP_ALLOW_INSECURE=1. | |
| MACP_TLS_CA_FILE | No | PEM bundle for a private CA. Cannot be combined with MACP_ALLOW_INSECURE. | |
| MACP_ALLOW_INSECURE | No | Set to 1 to use plaintext gRPC. For a local runtime only. Cannot be combined with MACP_TLS_CA_FILE. | off |
| MACP_DEFAULT_TTL_MS | No | Session TTL used when start_session is called without ttl_ms. | 300000 |
| MACP_REPLAY_IDLE_MS | No | How long a history read waits for the next envelope before treating the replay as complete. | 1000 |
| MACP_RUNTIME_TARGET | No | Runtime gRPC address (host:port). | 127.0.0.1:50051 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
These tools let you run or join a MACP Decision session (macp.mode.decision.v1):
a bounded, auditable vote among named agents that ends in one binding Commitment.
You act as the MACP agent named in the you / sender fields of tool results.
Typical loop:
start_session (initiator) -> share the returned session_id with the other participants.
propose an option; participants evaluate (optional) and vote on it.
get_session to see proposals, votes and the majority winner.
commit (the initiator) to resolve the session with the outcome.
get_commitment returns the binding outcome and its RFC-MACP-0013 commitment hash; verify recomputes that hash from the payload bytes the runtime recorded.
To join a session someone else started, you only need its session_id and to be a participant. The runtime enforces membership, ordering and identity; a rejected action returns an error.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| start_sessionA | Start a new MACP Decision session with this agent as initiator. Returns the new session_id; share it with the other participants so they can join. |
| proposeC | Put an option up for decision in a session. |
| evaluateA | Record a scored assessment of a proposal before voting (optional step). |
| voteA | Cast this agent's vote on a proposal. One vote per agent per proposal. |
| commitA | Resolve the session with a binding Commitment (normally the initiator). After this the session is RESOLVED and accepts no further messages. |
| get_sessionA | Show a session's state, participants, proposals, evaluations, votes and winner. Reads the runtime's session history, so it includes every participant's messages. |
| get_commitmentA | Return a resolved session's binding Commitment and its RFC-MACP-0013 hash.
|
| verifyA | Check a commitment hash by recomputing it (RFC-MACP-0013). Pass exactly one of session_id or payload_b64. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool maps cleanly to a distinct step in the MACP decision protocol: session setup, proposing, optional evaluation, voting, committing, and retrieval/verification. The descriptions sharply distinguish the closely related read operations (get_session returns full state, get_commitment returns only the binding commitment, verify recomputes a hash).
All names are snake_case and use clear verb-based forms, with read operands prefixed by get_ (get_session, get_commitment) and actions as bare verbs (propose, evaluate, vote, commit). The mix of get_x and bare action verbs is a minor deviation from a single verb_noun pattern but remains readable and predictable.
Eight tools is well-scoped for a focused decision-session protocol, with each tool earning its place in the lifecycle. There is no bloat or missing obvious primitive that would make the set feel thin.
The surface covers the core decision lifecycle: session creation, proposal, evaluation, voting, commitment, state inspection, and hash verification. Minor gaps remain—no explicit join/leave, abort/cancel, or list-sessions operation—but these are not central to the stated protocol.