Skip to content
Tireless Crew Docs

API and MCP

To work with the platform from your own tools, create an API key and connect to the MCP server. The tools you can call depend on the role of the account that owns the key.

Authentication

Every request carries an API key as a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create and revoke keys on the API keys page in your dashboard; you are asked to confirm it is you before the page opens. A key acts as the user who created it, and every action taken with it is recorded against that user. The key is shown once, when you create it. Only a SHA-256 hash of it is stored, so copy it somewhere safe straight away.

MCP server

The platform runs a Model Context Protocol (MCP) server at:

POST https://app.tirelesscrew.com/api/mcp

It follows the streamable HTTP transport of the MCP specification, protocol version 2025-03-26. A JSON-RPC request gets a response; a notification (no id) gets an empty 202 Accepted; and initialize returns an Mcp-Session-Id header. Any MCP client that supports this transport can connect. Desktop clients that only speak local MCP can connect through the mcp-remote bridge.

Calling a tool

curl -X POST 'https://app.tirelesscrew.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "jsonrpc": "2.0",
    "id":      1,
    "method":  "tools/call",
    "params": {
      "name":      "list_agents",
      "arguments": {}
    }
  }'

Call tools/list to see exactly which tools your key can use, with their input schemas. If you call a tool your role does not allow, the result is an error that says the tool is not available for your role.

Tools for customer keys

Agents and runs

Agent and run tools
ToolWhat it does
list_agentsLists your agents.
get_agentReads one agent by its ID, including its tools.
get_agent_user_config, set_agent_user_configRead and save your settings for an agent.
connect_agent_toolLinks one of your saved credentials to a tool on an agent you can use.
run_agentStarts a run with the same checks as the Run now button, including your balance. Returns a run_id.
get_run_statusReads a run’s status, output, cost in dollars and timing, and a plain error message if it failed.
list_agent_runsLists your runs. Filter by agent_id or status.
request_agent_accessAsks for access to an agent in the catalog. A second request while one is pending is refused.

Credentials

Credential tools
ToolWhat it does
list_credentialsLists your saved credentials: names and key names only, never the values.
create_credentialSaves a new named credential.
update_credentialChanges the keys you pass and keeps the rest.
delete_credentialDeletes a credential. Tools using it lose access.
upsert_credentialCreates or replaces the credential for a tool, by the tool’s slug.
list_credential_templatesLists the sign-in types you can save, with the fields each one needs.

Destinations

Destination tools
ToolWhat it does
list_destinationsLists your destinations for an agent.
create_destinationAdds an email, webhook or slack_webhook destination to an agent.
update_destinationTurns a destination on or off.
delete_destinationRemoves a destination.

Knowledge, conversations and website chat

  • Knowledge bases: list_knowledge_bases, get_knowledge_base, create_knowledge_base, update_knowledge_base, delete_knowledge_base, add_kb_document, reindex_kb_document, delete_kb_document, and bind_user_kb / unbind_user_kb to let an agent search one.
  • Conversations with an agent: open_agent_session, post_session_message, get_agent_session, close_agent_session.
  • Your website chat on an agent: get_embed_config, update_embed_config, regenerate_embed_key.
  • The onboarding and account emails we have sent you: list_lifecycle_emails.

Organizations

Customer keys can also manage your organizations: departments and seats, work assignments, automatic acceptance, budgets, goals, leads and outreach settings, suppressions, website publishing settings, and which skills and knowledge bases each department or seat has. Call tools/list for the full list.

Support and admin keys

A support key can run agents, save its own agent settings, and read agents, runs, tools, templates, destinations, credentials and an agent’s memories. It cannot create or delete anything. An admin key can use every tool, including the platform tools that customers never see, such as list_reasoning_models, create_agent, publish_agent, list_agent_templates and the tool library.

Chat endpoint

Chat endpoints
EndpointDescription
POST https://app.tirelesscrew.com/api/v1/chat Sends a list of messages (each with a role and content) to a model, with optional options such as max_tokens. Needs an API key and is charged to your balance. The result is in data.
GET https://app.tirelesscrew.com/api/v1/models Lists the models the chat endpoint accepts. No API key needed.

Errors and limits

HTTP status codes
StatusMeaning
401The Authorization header is missing, or the key is not valid.
402Your balance is too low for the request.
422The request is missing a required field or has an invalid value.
429Too many requests. The MCP server allows 120 requests a minute per key; the REST endpoints allow 60.
500Something went wrong on our side. If it keeps happening, contact support.