Skip to main content

​
MCP Examples

​
1) Discover Session Context

Use this first to confirm workspace and brain selection. 
{
  "tool": "get_session",
  "arguments": {}
}

​
2) Browse Then Read

Keyword browse: 
{
  "tool": "grep",
  "arguments": {
    "query": "neurons/support"
  }
}
Then read a returned path: 
{
  "tool": "read",
  "arguments": {
    "path": "neurons/abc-123"
  }
}

{
  "tool": "search",
  "arguments": {
    "query": "pathways/customer escalation"
  }
}
Use returned path values with read for full records.

​
4) Invoke A Receptor

{
  "tool": "invoke",
  "arguments": {
    "path": "receptors/support-bot",
    "message": "Summarize open incidents"
  }
}

​
5) Create Resource

{
  "tool": "write",
  "arguments": {
    "path": "neurons/customer-support-agent",
    "description": "A support neuron that handles billing and refund questions."
  }
}

​
6) Update Resource

{
  "tool": "edit",
  "arguments": {
    "path": "neurons/neuron-uuid",
    "config": {
      "description": "Handles support issues with concise responses."
    }
  }
}

​
7) Work With History

Search execution history: 
{
  "tool": "grep_history",
  "arguments": {
    "query": "incident"
  }
}
Read history entry: 
{
  "tool": "read_history",
  "arguments": {
    "path": "engrams/engram-uuid"
  }
}

​
8) MCP App Rendering

For receptor paths, read can return the receptor viewer MCP app resource:
  • ui://receptor-viewer/mcp-app.html
Clients that support MCP Apps (for example Claude and ChatGPT) can render that UI.

​
9) Run A Connect Integration Tool

Use direct execution with an integration that is already configured in AUVY, then call connect_execute with integration_id, tool_name, and tool_config. 
{
  "tool": "connect_execute",
  "arguments": {
    "integration_id": "integration-uuid",
    "tool_name": "GMAIL_SEND_EMAIL",
    "tool_config": {
      "to": "alex@example.com",
      "subject": "Status update",
      "body": "The run completed successfully."
    }
  }
}

​
10) Add Brain Context

For brain-scoped search or history tools, include X-Brain-Id in your MCP server config: 
{
  "mcpServers": {
    "auvy": {
      "url": "https://mcp.auvy.ai/mcp",
      "headers": {
        "Authorization": "Bearer ak_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "X-Brain-Id": "00000000-0000-0000-0000-000000000000"
      }
    }
  }
}