MCP

Roster exposes an MCP server at:

/mcp

MCP is the primary agent-native integration surface. It supports open-ended business routing through resolve and exact tools for project, participant, label, delegation, directory, and resolve-history workflows.

Use MCP For

natural-language routing questions
agent-native project and participant management
exact membership checks
delegation management
resolve request history

Client Setup

Use the dedicated setup guides for client-specific connection details:

Tool Routing

Use resolve for open-ended business questions such as who should handle a task, who to contact, who is responsible, or who can act through an active delegation.

Use exact tools for exact data checks. For example, to check whether a user or group belongs to a project, list projects, list participants, then list participant members.

Resolve Runtime

The resolve tool accepts a natural-language query. Project references, labels, participant roles, and other constraints are extracted by the resolver. The runtime then selects matching participants and resolves associated users, including active delegations.

When a query includes an amount and candidate participants expose approval-limit metadata, Resolve should choose the lowest-scope participant that covers the amount. It should not add executive sponsor or escalation participants unless the amount exceeds the lower approval limit or the user explicitly asks for escalation.

Top-level MCP response status is one of:

ok
configuration_error
agent_error
server_error

When status is ok, result.resolution_status is one of:

success
out_of_scope
not_found