Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MACP_AGENT_IDNoThe 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_TOKENNoBearer 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_FILENoPEM bundle for a private CA. Cannot be combined with MACP_ALLOW_INSECURE.
MACP_ALLOW_INSECURENoSet to 1 to use plaintext gRPC. For a local runtime only. Cannot be combined with MACP_TLS_CA_FILE.off
MACP_DEFAULT_TTL_MSNoSession TTL used when start_session is called without ttl_ms.300000
MACP_REPLAY_IDLE_MSNoHow long a history read waits for the next envelope before treating the replay as complete.1000
MACP_RUNTIME_TARGETNoRuntime 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:

  1. start_session (initiator) -> share the returned session_id with the other participants.

  2. propose an option; participants evaluate (optional) and vote on it.

  3. get_session to see proposals, votes and the majority winner.

  4. commit (the initiator) to resolve the session with the outcome.

  5. 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

found is false while the session is still open. payload_b64 is the exact Commitment payload bytes the runtime recorded; commitment_hash is computed over them.

verifyA

Check a commitment hash by recomputing it (RFC-MACP-0013).

Pass exactly one of session_id or payload_b64. outcome is match, mismatch, or cannot_verify (the payload itself is not hashable under the label).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 8 tools

Disambiguation5/5

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).

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues