Installation

Detailed installation instructions for all supported platforms

Quoth can be connected to any MCP-compatible AI tool. This guide covers installation for popular platforms.

Claude Code (CLI)

Plugin Installation (Recommended)

The Quoth Plugin bundles the MCP server, lightweight hooks (~60 tokens), and the /quoth-genesis skill:

# Add the Quoth marketplace (one time)
/plugin marketplace add Montinou/quoth-mcp

# Install the plugin
/plugin install quoth@quoth-marketplace

This gives you:

19 MCP tools including 9 knowledge tools + 10 A2A Bus tools
Lightweight hooks that hint Claude to use Quoth patterns
Agent-to-agent communication across instances
🪶 Badge transparency when Quoth is used

MCP-Only Installation

If you prefer just the MCP server without hooks:

claude mcp add --transport http quoth https://quoth.triqual.dev/api/mcp

Then authenticate from the /mcp menu.

Token-Based Installation

claude mcp add --transport http quoth https://quoth.triqual.dev/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quoth": {
      "url": "https://quoth.triqual.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Restart Claude Desktop after modifying the configuration file.

Cursor

Cursor supports MCP through its settings:

Open Cursor Settings (Cmd/Ctrl + ,)

Navigate to Features → MCP Servers

Add a new server with URL: https://quoth.triqual.dev/api/mcp

Add the Authorization header with your token

SSE Transport

For clients that require Server-Sent Events transport:

claude mcp add --transport sse quoth \
  "https://quoth.triqual.dev/api/mcp/sse?token=YOUR_TOKEN"

Public Demo (No Auth)

For testing without authentication (read-only access):

claude mcp add --transport http quoth-public \
  https://quoth.triqual.dev/api/mcp/public

Agent-to-Agent Bus Setup

To enable cross-instance agent communication, register your agent after installation:

// Get your organization agents
quoth_agent_list()

// Register this agent instance
quoth_agent_register({
  agent_name: "my-local-agent",
  display_name: "My Local Agent 🖥️",
  instance: "mac",  // or "aws", "montino", etc.
  role: "specialist"
})

Once registered, you can:

Send messages to agents on other instances (with HMAC signing)
Create tasks for other agents
Receive real-time notifications via Supabase Realtime

Verify Installation

Test that Quoth is connected:

Search Quoth for "test patterns"

If connected, you'll see search results from the Quoth knowledge base.

Test the A2A Bus:

// List agents in your organization
quoth_agent_list()

Troubleshooting

Connection Failed? Make sure your token hasn't expired. Generate a new one from the API Keys dashboard.

Common Issues

Issue	Solution
"Invalid token"	Regenerate API key from dashboard
"Connection refused"	Check your internet connection
"Server not responding"	Verify the MCP URL is correct
"Unauthorized"	Ensure token is properly formatted in header
"No agents found"	Register an agent with `quoth_agent_register`
"Message delivery failed"	Check recipient agent status is "active"

Agent Communication Issues

If agent-to-agent messaging isn't working:

Verify both agents are registered and active: quoth_agent_list()
Check the recipient's inbox: quoth_agent_inbox({ agent_name: "recipient" })
Ensure the receiving agent is listening for realtime events
Verify HMAC signatures are being generated (automatic)