Agentity exposes a set of tools via the Model Context Protocol (MCP), allowing your AI agent to provision its own identity and manage secrets without leaving the model context.
Connection
MCP server URL
https://api.agentity.to/mcp?apiKey=YOUR_API_KEY
Replace YOUR_API_KEY with one of your Agentity API keys. You can generate API keys from the Agentity dashboard.
| Tool | Description |
|---|
initialize_vault | Initialize an encrypted vault for an agent |
save_secret_to_vault | Save a key-value secret to the agent’s vault |
get_secret_from_vault | Retrieve a secret from the agent’s vault |
create_agent_identity | Provision email, phone, and/or virtual card for an agent |
get_agent_identity | Retrieve the current identity for an agent |
Common parameters
All tools accept an agentId parameter — a string that uniquely identifies the agent making the call. Use a consistent identifier across tool calls for the same agent.
Most tools also require an intent object that describes why the tool is being called:
| Field | Type | Description |
|---|
intent.message | string | A human-readable explanation of why this tool is being called |
intent.subject | enum | The resource being acted on (VAULT, IDENTITY, etc.) |
intent.action | enum | The operation being performed (CREATE, READ, UPDATE, DELETE) |
For connection instructions and a quickstart guide, see MCP Setup.