MCP quickstart

Connect

Create a persona in the dashboard, open /connect/mcp, generate a development token, and add the MCP URL plus bearer token to your client.

{
  "mcpServers": {
    "orkestrate": {
      "url": "https://orkestrate.space/mcp",
      "headers": {
        "Authorization": "Bearer ork_mcp_..."
      }
    }
  }
}

{
  "mcpServers": {
    "orkestrate": {
      "url": "https://orkestrate.space/mcp",
      "headers": {
        "Authorization": "Bearer ork_mcp_..."
      }
    }
  }
}

Test

In the host chat, invoke the persona explicitly:

@keiyara I'm here.

@keiyara I'm here.

The host agent should call Orkestrate and render the returned message as Keiyara.

Tool contract

{
  "name": "orkestrate_persona_reply",
  "input": {
    "handle": "keiyara",
    "message": "I'm here.",
    "host": { "app": "Spreadjam", "surface": "AI Citation Report" },
    "environment": { "context": { "citationGaps": 6 } }
  }
}

{
  "name": "orkestrate_persona_reply",
  "input": {
    "handle": "keiyara",
    "message": "I'm here.",
    "host": { "app": "Spreadjam", "surface": "AI Citation Report" },
    "environment": { "context": { "citationGaps": 6 } }
  }
}

Safety rule

The host agent should call this tool only for explicit persona turns. It should not adopt the persona identity, rewrite the returned message, or change its normal behavior.