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": [
    {}
  ]
}
'

POST

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 via Authorization: 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 selected

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

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

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Grant Agent Access

Authentication

Example Request

Example Response

Status Codes

​Authentication

​Example Request

​Example Response

​Status Codes

Authentication

Example Request

Example Response

Status Codes