MCP Tools Reference

Quoth exposes tools through the Model Context Protocol (MCP) in two contexts:

• Local plugin (quoth-learning server): 22 tools for self-learning, pattern management, intelligence routing, and agent coordination — runs on the developer's machine via stdio
• Cloud platform (quoth.triqual.dev/api/mcp): 18 tools for cross-team knowledge sharing, search, memory, messaging, and project management — runs on Vercel

This page documents the cloud MCP tools. For local plugin tools, see the plugin documentation.

Tools Overview

Search Tools (3)

Memory Tools (4)

Agent Tools (7)

Project Tools (3)

Genesis Tool (1)

---

Search Tools

quoth_search_index

Semantic search across project documentation using an HNSW vector index. Returns ranked results with similarity scores. Embeddings are generated via Vercel AI Gateway (text-embedding-3-large, 2000d).

Parameters

Scopes:

• project: Current project only
• shared: Cross-project shared knowledge
• org: All organization documents

quoth_read_doc

Read the full content of a document by ID or path. Returns complete content with metadata.

quoth_read_chunks

Read specific chunks of a document by chunk ID. Token-efficient for retrieving only the sections you need.

---

Memory Tools

Agent memory is persisted with automatic embedding generation via Vercel AI Gateway (text-embedding-3-large, 2000d).

quoth_memory_store

Store a memory entry for the calling agent. Supports namespaces, tags, TTL, and arbitrary metadata.

quoth_memory_search

Semantic search across agent memories. Returns results with similarity scores. Access triggers fire-and-forget relevance boosting.

quoth_memory_list

List agent memories with filtering by namespace, tier, and pagination.

quoth_memory_forget

Delete a specific memory by key, or delete all memories in a namespace.

At least one of key or namespace is required.

---

Agent Tools

The async message bus enables communication between agents across different instances (AWS, Montino, WSL2, etc.) with HMAC-SHA256 signing for message verification.

quoth_agent_register

Register an agent in the registry with capabilities, model, and role. Generates an HMAC signing key on registration.

quoth_agent_register({
  agent_name: "deployer",
  display_name: "Deployer",
  instance: "montino",
  role: "specialist",
  model: "anthropic/claude-sonnet-4-6"
})

quoth_agent_list

List all agents in the organization.

quoth_agent_assign

Assign an agent to a project with a specific role.

quoth_agent_send_message

Send a message to another agent via the async communication bus. Messages are HMAC-SHA256 signed.

quoth_agent_inbox

Read messages from the agent's inbox with delivery tracking.

quoth_agent_tasks

List, claim, or complete tasks from the structured task queue.

quoth_agent_task_reassign

Reassign a task to a different agent. Requires admin role.

---

Project Tools

quoth_project_create

Create a new project within an organization.

quoth_project_invite

Invite a user or agent to a project.

quoth_token_generate

Generate an MCP access token for a project. Enables programmatic token rotation without the dashboard.

---

Genesis Tool

quoth_genesis

Bootstrap project documentation by scanning the codebase. Supports three depth levels:

• minimal: 3 core documents (architecture overview, API contracts, setup guide)
• standard: 5 documents (adds patterns and decisions)
• comprehensive: 11 documents (full knowledge base)

---

Cross-Instance Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ AWS Agents  │◄───►│  Quoth Bus  │◆───►│ Montino     │
│ (morfeo,    │     │  (async     │     │ Agents      │
│  life)      │     │  message    │     │ (deployer,  │
└─────────────┘     │  bus)       │     │  ads, echo) │
                    └─────────────┘     └─────────────┘

All agents authenticate with their own project-scoped MCP token. Messages are delivered via the async message bus with HMAC-SHA256 signing for verification.

Priority Levels

---

Cloud API Endpoints

In addition to MCP tools, Quoth exposes REST endpoints for managed mode and cross-org integrations.

Pipeline Processing

POST /api/v1/pipeline/process

Cloud trajectory processing pipeline for managed mode users. Replaces local Haiku subagent processing.

curl -X POST https://quoth.triqual.dev/api/v1/pipeline/process \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"trajectory": {...}, "project_id": "my-project"}'

Doc Update

POST /api/v1/docs/update

Cloud document updater for managed mode users. Triggers content-hash-based doc updates without requiring local git access.

Cross-Org Pattern Sharing

Share and discover patterns across organizations.

List Shared Patterns

GET /api/v1/patterns/shared

Share a Pattern

POST /api/v1/patterns/shared

---

Routing

The local plugin includes task routing with 20+ categories (v3.3.0), including Spanish-language and accent-agnostic keyword matching. Routing uses the Unix socket (~/.quoth/daemon.sock) for ~20ms response times.

Categories include: code, test, debug, deploy, docs, design, security, database, api, frontend, backend, infra, git, review, refactor, performance, accessibility, i18n, marketing, sales, spanish, and more.

---

Embeddings

Cloud embeddings use Venice BGE-M3 (migrated from voyage-4-lite in v3.3.0). Local plugin supports batch embedding via generateEmbeddingBatch() for cost optimization when processing multiple trajectories.

---

Rate Limits