Skip to main content

​
Agent Manifest

Get the AIP agent manifest for discovery. This endpoint follows the open AIP specification.

​
Query Parameters

​
agent
string
Specific agent slug. If omitted, returns platform manifest.
# Platform manifest
curl https://api.runtools.ai/.well-known/aip/agent \
  -H "X-API-Key: rt_live_xxx"

# Specific agent manifest
curl "https://api.runtools.ai/.well-known/aip/agent?agent=code-assistant" \
  -H "X-API-Key: rt_live_xxx"

{
  "aip_version": "0.1.0",
  "agent": {
    "id": "code-assistant",
    "name": "Code Assistant",
    "version": "1.0.0",
    "manifest_hash": "sha256:abc123...",
    "capabilities": {
      "code_generation": true,
      "file_editing": true,
      "terminal_execution": true,
      "web_search": false
    },
    "context_requirements": {
      "max_tokens": 200000,
      "supported_block_types": ["conversation", "file", "diff", "event", "note"]
    },
    "tools": ["bash", "read_file", "edit_file", "web_search"],
    "models": ["claude-opus-4-5", "gpt-4o"],
    "invoke": "/.well-known/aip/invoke",
    "stream": true
  }
}

​
List Agents

List all available agents with their capabilities.

​
Query Parameters

​
capability
string
Filter by capability
curl https://api.runtools.ai/v1/aip/agents \
  -H "X-API-Key: rt_live_xxx"

{
  "data": [
    {
      "id": "code-assistant",
      "name": "Code Assistant",
      "capabilities": ["code_generation", "file_editing", "terminal_execution"],
      "status": "active"
    },
    {
      "id": "researcher",
      "name": "Research Agent",
      "capabilities": ["web_search", "summarization"],
      "status": "active"
    }
  ]
}

​
Discover Agents

Find agents by capabilities and requirements (for agent mesh).

​
Request Body

​
domain
string
Domain to search in (e.g., software_development, data_analysis)
​
capabilitiesRequired
array
Required capabilities
​
maxCost
number
Maximum cost per request
curl -X POST https://api.runtools.ai/v1/aip/discover \
  -H "X-API-Key: rt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "data_analysis",
    "capabilitiesRequired": ["sql_execution", "visualization"]
  }'

{
  "data": {
    "agents": [
      {
        "id": "data-analyst",
        "name": "Data Analyst",
        "matchScore": 0.95,
        "capabilities": ["sql_execution", "visualization", "python"],
        "availability": "online",
        "estimatedCost": 0.02
      }
    ]
  }
}

​
Hub Info

Get AIP Hub information and status. 
curl https://api.runtools.ai/v1/aip/hub \
  -H "X-API-Key: rt_live_xxx"

{
  "data": {
    "version": "0.1.0",
    "type": "runtools_cloud",
    "features": {
      "sessions": true,
      "blocks": true,
      "search": true,
      "enrichment": true,
      "mesh": true,
      "auto_tagging": true
    },
    "limits": {
      "maxSessions": 1000,
      "maxBlocksPerSession": 10000,
      "maxTokensPerSession": 500000
    },
    "status": "operational"
  }
}