Grant Agent Access
curl --request POST \
--url https://api.app.shinzo.ai/v1/mcp/servers/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_uuid": "<string>",
"access_mode": "<string>",
"allowed_tools": [
{}
]
}
'MCP Servers
Grant Agent Access
Grant an agent access to an MCP server’s tools.
POST
/
v1
/
mcp
/
servers
/
{id}
/
access
Grant Agent Access
curl --request POST \
--url https://api.app.shinzo.ai/v1/mcp/servers/{id}/access \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_uuid": "<string>",
"access_mode": "<string>",
"allowed_tools": [
{}
]
}
'Authentication
Requires JWT token or Platform API key viaAuthorization: Bearer <token> header.
string
required
MCP server UUID
string
required
UUID of the agent to grant access to
string
default:"all"
Access mode:
all or selectedarray
List of tool names to allow. Required when
access_mode is selectedExample Request
Grant access to all tools:curl -X POST https://api.app.shinzo.ai/v1/mcp/servers/a1b2c3d4-e5f6-7890-abcd-ef1234567890/access \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"agent_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}'
curl -X POST https://api.app.shinzo.ai/v1/mcp/servers/a1b2c3d4-e5f6-7890-abcd-ef1234567890/access \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"agent_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"access_mode": "selected",
"allowed_tools": ["create_issue", "list_issues"]
}'
Example Response
{
"id": "grant-uuid-1",
"agent_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"access_mode": "selected",
"allowed_tools": ["create_issue", "list_issues"],
"enabled": true,
"created_at": "2026-01-15T10:00:00Z"
}
Status Codes
| Code | Description |
|---|---|
201 | Access granted successfully |
400 | Invalid request (validation error) |
401 | Unauthorized - invalid or missing authentication |
404 | MCP server or agent not found |
409 | Agent already has access to this server |