Skip to main content
Agentity exposes its tools as an MCP (Model Context Protocol) server. Any MCP-compatible agent framework can connect to it and call tools to provision and manage agent identities. The MCP server URL is: 
https://api.agentity.to/mcp?apiKey=YOUR_API_KEY

​
Adding to your MCP client

1

Generate an API key

Create an API key from the dashboard. Make sure you have supplied api keys for all providers you support.
2

Add the server config to your MCP client

Add the following to your MCP client configuration, replacing YOUR_API_KEY with the key you generated:
mcp config
{
  "mcpServers": {
    "agentity-mcp": {
      "type": "http",
      "url": "https://api.agentity.to/mcp?apiKey=YOUR_API_KEY"
    }
  }
}
3

Verify the connection

After connecting, your agent should see the following tools exposed by the server:
  • initialize_vault
  • save_secret_to_vault
  • get_secret_from_vault
  • create_agent_identity
  • get_agent_identity

​
Passing agent IDs

Every tool call requires a unique agentId string that identifies the agent making the call. Use a stable identifier — a UUID or a meaningful name — so the agent can reliably retrieve the same identity and vault across sessions.
Give each distinct agent a unique, stable agentId. If you use the same agentId across sessions, the agent will retrieve the same identity each time.
The MCP server uses Streamable HTTP transport (not WebSocket or stdio). Make sure your MCP client supports this transport type.