Skip to main content
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": [
    {}
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.
​
id
string
required
MCP server UUID
​
agent_uuid
string
required
UUID of the agent to grant access to
​
access_mode
string
default:"all"
Access mode: all or selected
​
allowed_tools
array
List of tool names to allow. Required when access_mode is selected

​
Example 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"
  }'
Grant access to specific tools only: 
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

CodeDescription
201Access granted successfully
400Invalid request (validation error)
401Unauthorized - invalid or missing authentication
404MCP server or agent not found
409Agent already has access to this server