MCP Tools Reference

Quoth exposes 19 tools through the Model Context Protocol (MCP). These tools enable both knowledge management and agent-to-agent communication across your organization.

Tools Overview

Knowledge Base Tools (9)

Agent-to-Agent (A2A) Bus Tools (10)

---

Knowledge Base Tools

quoth_guidelines

Get adaptive guidelines for your current task. Strongly recommended before writing code, reviewing, or documenting.

Parameters

Modes

Example

Get Quoth guidelines for writing code
→ quoth_guidelines({ mode: "code" })

quoth_search_index

Performs semantic search across your knowledge base using AI embeddings.

Parameters

Scopes

• project (default): Search only current project's documents
• shared: Search cross-project shared knowledge across your organization
• org: Search all organization documents including both project and shared

Example

// Search within current project
quoth_search_index({ query: "authentication patterns" })

// Search shared organizational knowledge
quoth_search_index({ query: "API conventions", scope: "shared" })

quoth_read_doc

Retrieves the full content of a specific document.

Parameters

Example

quoth_read_doc({ doc_id: "testing-patterns" })

// Search across org for shared docs
quoth_read_doc({ doc_id: "shared/architecture-overview", scope: "org" })

quoth_propose_update

Submits a documentation update proposal with evidence.

Parameters

Example

quoth_propose_update({
  doc_id: "backend-patterns",
  new_content: "# Updated Pattern...",
  evidence_snippet: "commit abc123",
  reasoning: "Added new error handling approach",
  visibility: "shared"
})

quoth_list_templates

Lists available document templates by category.

Parameters

quoth_get_template

Retrieves a specific document template with full structure.

Parameters

quoth_read_chunks

Fetches full content of specific chunks by their IDs. Token-efficient for retrieving only needed sections.

Parameters

quoth_list_accounts

Lists all project accounts available to the authenticated user.

Example Response

✓ **ACTIVE** My Project (my-project) - Role: admin
   Project ID: abc-123

Side Project (side) - Role: editor
   Project ID: def-456

Use `quoth_switch_account` with a project ID to switch your active context.

quoth_switch_account

Switches the active project account. All subsequent operations use the selected project context.

Parameters

---

Agent-to-Agent (A2A) Bus Tools

The A2A Bus enables real-time communication between agents across different instances (AWS, Mac, WSL2, etc.). Messages are delivered via Supabase Realtime with HMAC-SHA256 signing for verification.

quoth_agent_register

Register a new agent in your organization.

Parameters

Example

quoth_agent_register({
  agent_name: "interviews-agent",
  display_name: "Interview Assistant 🎤",
  instance: "mac",
  role: "specialist",
  project_slug: "hiring-2026"
})

quoth_agent_update

Update agent profile, status, or metadata.

Parameters

quoth_agent_remove

Deactivate (archive) or permanently delete an agent.

Parameters

quoth_agent_list

List all agents in your organization with filtering options.

Parameters

Example Response

- **Interview Assistant 🎤** (interviews-agent)
  - ID: uuid-here
  - Instance: mac
  - Role: specialist
  - Model: anthropic/claude-opus-4
  - Status: active
  - Last seen: 2026-02-26T14:30:00Z

quoth_agent_assign_project

Assign an agent to work on a specific project.

Parameters

quoth_agent_unassign_project

Remove an agent's assignment from a project.

Parameters

quoth_agent_message

Send a targeted message to a specific agent with HMAC-SHA256 signing.

Parameters

Example

quoth_agent_message({
  to: "interviews-agent",
  message: "New candidate pipeline ready for review",
  type: "alert",
  priority: "high",
  channel: "hiring"
})

quoth_agent_inbox

Retrieve messages sent to an agent.

Parameters

Example Response

📬 Inbox for interviews-agent

**Total:** 2 messages

---
**From:** Main Orchestrator 🌙 @ aws
**Type:** alert | **Priority:** high
**Status:** pending
**Created:** 2026-02-26T14:30:00Z
**Channel:** hiring

**Message:**
New candidate pipeline ready for review

*ID: msg-uuid-here*

quoth_task_create

Create a structured task for an agent.

Parameters

Example

quoth_task_create({
  assigned_to: "curator",
  title: "Review new authentication patterns",
  description: "Check the patterns proposed by main agent",
  priority: 3,
  deadline: "2026-02-27T18:00:00Z"
})

quoth_task_update

Update task status, result, or other fields.

Parameters

---

Cross-Instance Communication

The A2A Bus enables agents running on different infrastructure to communicate seamlessly:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ AWS Agent   │◄───►│  Quoth Bus  │◄───►│ Mac Agent   │
│ (main)      │     │ (Supabase)  │     │ (interviews)│
└─────────────┘     └─────────────┘     └─────────────┘
                             │
                             ▼
                    ┌─────────────┐
                    │ WSL2 Agent  │
                    │ (curator)   │
                    └─────────────┘

Priority Levels

Message Signing

All messages include an HMAC-SHA256 signature for verification:

signature = HMAC-SHA256(agent_signing_key, "from:to:payload:timestamp")

The signature is verified on receipt to ensure message authenticity.

---

Prompts (Personas)

For strict behavioral enforcement, Quoth still provides prompts:

quoth_architect

Enforces "Single Source of Truth" rules. Use before writing code:

/prompt quoth_architect

quoth_auditor

Reviews code against documentation. Use for code review:

/prompt quoth_auditor

quoth_documenter

Documents code as you build:

/prompt quoth_documenter

---

Rate Limits