ajan Agent MCP Server
Access your ajan agents from any MCP-compatible AI client. The ajan MCP Server exposes your workspace agents as MCP tools.
The ajan MCP Server exposes your ajan agents as MCP tools, allowing any MCP-compatible AI client to interact with your workspace agents.
MCP Base URL
The ajan MCP server is available at https://api.ajan.io/mcp.
If your organization uses a dedicated ajan deployment (custom domain), use your deployment's endpoint instead: https:///api/public/mcp. Replace https://api.ajan.io/mcp with this URL throughout this guide.
Authentication
The MCP endpoint requires a valid ajan API key with the Agent API scope.
Supported Authentication Methods
| Header Type | Header Format |
|---|---|
| Bearer | Authorization: Bearer |
| X-API-Key | x-api-key: |
Available Tools
The ajan MCP Server exposes three tools:
| Tool | Description |
|---|---|
find_agent | Search for an agent ID by name |
ask_agent | Send a prompt to an agent specified by its ID |
ask_custom_agent | Configure and query a custom agent on-the-fly |
find\_agent
Use this to look up an agent's ID when you only know its name. This is helpful when you want to call ask_agent but need to find the correct agent ID first.
ask\_agent
Send a prompt to a specific agent using its ID. The agent processes your request using its configured model, instructions, and connected integrations.
For multi-turn conversations, pass previous turns through the optional messageHistory parameter. Each entry has a role of user or assistant and a content string. Order entries from oldest to newest; the current prompt is appended as the latest user turn.
{
"agentId": "agent_123",
"prompt": "And what about Berlin?",
"messageHistory": [
{ "role": "user", "content": "What's the weather in Munich?" },
{ "role": "assistant", "content": "Munich is currently 18°C and sunny." }
]
}ask\_custom\_agent
Create a temporary agent with custom settings for a single query. Useful when you need specific behavior without creating a permanent agent in ajan.
Connecting from ajan
You need the Create integrations permission to add this MCP server. If Add integration is not visible, ask a workspace admin to grant you this permission or create the integration for you.
If you want to add this MCP server as an integration within ajan itself, follow these steps:
Navigate to Integrations
Open Integrations from the main navigation.
Add MCP Integration
Click Add integration, choose Start from scratch, then select Connect remote MCP.
Enter Server Details
- URL:
https://api.ajan.io/mcp- Authentication method API Key
Save & Test
- Click Create and connect
- Add a connection using a valid ajan API key (must have the Agent API scope)
- Set the API Key Header Type to Authorization: Bearer
- Click Test connection to verify access to the available tools
Related Documentation
- Model Context Protocol (MCP) - Learn about MCP and how to connect other MCP servers
- MCP Server Directory - Browse official MCP servers
- Agents API Guide - Use the Agents API directly
FAQ
Use the ajan Agent MCP Server when an external MCP-compatible client should access ajan agents as tools. It is useful when teams want to reuse ajan agents outside the ajan interface.
Check the MCP client configuration, authentication, agent sharing, available tools, and whether the target agent is published and accessible. Also verify that the external client supports the required MCP behavior.