MCP Tools Reference
Complete reference for all 28 Quoth MCP tools
Quoth exposes 28 tools through the Model Context Protocol (MCP). These tools enable knowledge management, project administration, agent-to-agent communication, and full self-provisioning across your organization.
Tools Overview
Knowledge Base Tools (9)
| Tool | Purpose | Auth |
|---|---|---|
quoth_guidelines | Adaptive guidelines for coding/review/documentation | Yes |
quoth_search_index | Semantic search across documentation | Yes |
quoth_read_doc | Read full document content | Yes |
quoth_propose_update | Submit documentation updates | Editor+ |
quoth_list_templates | List available templates | Yes |
quoth_get_template | Fetch template structure | Yes |
quoth_read_chunks | Fetch specific chunks by ID | Yes |
quoth_list_accounts | List available project accounts | Yes |
quoth_switch_account | Switch active project context | Yes |
Project Management Tools (6)
| Tool | Purpose | Auth |
|---|---|---|
quoth_project_list | List all projects in organization | Yes |
quoth_project_read | Read project details | Yes |
quoth_project_create | Create a new project | Admin |
quoth_project_update | Update project settings | Admin |
quoth_project_delete | Delete a project (with confirmation) | Admin |
quoth_reindex | Reindex project documentation | Admin |
Agent-to-Agent (A2A) Bus Tools (10)
| Tool | Purpose | Auth |
|---|---|---|
quoth_agent_register | Register a new agent (auto-creates project) | Yes |
quoth_agent_update | Update agent profile/status | Yes |
quoth_agent_remove | Archive or delete an agent | Yes |
quoth_agent_list | List all agents in organization | Yes |
quoth_agent_assign_project | Assign agent to a project | Yes |
quoth_agent_unassign_project | Remove agent from project | Yes |
quoth_agent_message | Send message to another agent (HMAC signed) | Yes |
quoth_agent_inbox | Read agent's message inbox | Yes |
quoth_task_create | Create task for an agent | Yes |
quoth_task_update | Update task status/result | Yes |
Provisioning Tools (2)
| Tool | Purpose | Auth |
|---|---|---|
quoth_token_generate | Generate JWT MCP tokens programmatically | Admin |
quoth_project_provision_agent | One-shot: create project + register agent + generate token | Admin |
Documentation Bootstrap (1)
| Tool | Purpose | Auth |
|---|---|---|
quoth_genesis | Phased codebase scanning and documentation bootstrapping | Yes |
Knowledge Base Tools
quoth_guidelines
Get adaptive guidelines for your current task. Recommended before writing code, reviewing, or documenting.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mode | "code" | "review" | "document" | Yes | Task mode |
full | boolean | No | Full guidelines (~500 tokens) vs compact (~150 tokens) |
quoth_search_index
Semantic vector search across your knowledge base.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language search query (max 1000 chars) |
scope | "project" | "shared" | "org" | No | Search scope (default: project) |
Scopes:
- project: Current project only
- shared: Cross-project shared knowledge
- org: All organization documents
quoth_read_doc
Read full content of a specific document.
| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document title or path |
scope | "project" | "org" | No | Default: project |
quoth_propose_update
Submit a documentation update proposal with evidence. Requires editor+ role.
| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document to update |
new_content | string | Yes | Proposed new content (full markdown) |
evidence_snippet | string | Yes | Code or commit reference |
reasoning | string | Yes | Why this update is needed |
visibility | "project" | "shared" | No | Default: project |
quoth_list_templates / quoth_get_template
List and fetch document templates by category.
| Parameter | Type | Required | Description |
|---|---|---|---|
category | "all" | "architecture" | "patterns" | "contracts" | No | Default: all |
quoth_read_chunks
Fetch specific chunks by ID. Token-efficient for retrieving only needed sections.
| Parameter | Type | Required | Description |
|---|---|---|---|
chunk_ids | string[] | Yes | Array of chunk IDs (1-20) |
quoth_list_accounts / quoth_switch_account
List available project accounts and switch active context.
Project Management Tools
quoth_project_create
Create a new project in your organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | Project slug (lowercase, hyphens) |
github_repo | string | No | GitHub repo URL |
is_public | boolean | No | Default: false |
quoth_project_list
List all projects in your organization.
| Parameter | Type | Required | Description |
|---|---|---|---|
organization_id | string | No | Filter by org (uses current by default) |
quoth_project_read
Get details of a specific project.
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | No | Project UUID |
quoth_project_update
Update project settings (slug, repo, visibility, approval requirements).
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | No | Project UUID |
slug | string | No | New slug |
github_repo | string | No | New repo URL |
is_public | boolean | No | Visibility |
require_approval | boolean | No | Require approval for updates |
quoth_project_delete
Delete a project. Requires slug confirmation for safety.
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | Yes | Project UUID |
confirm_slug | string | Yes | Type the slug to confirm |
quoth_reindex
Reindex all documentation for a project (regenerates embeddings).
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | No | Uses current project if omitted |
Agent-to-Agent (A2A) Bus Tools
The A2A Bus enables real-time communication between agents across different instances (AWS, Mac, WSL2, etc.) via Supabase Realtime with HMAC-SHA256 signing.
quoth_agent_register
Register a new agent. If project_slug is provided and the project doesn't exist, it auto-creates the project and assigns the agent as owner.
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_name | string | Yes | Unique name (lowercase, hyphens) |
display_name | string | No | Human-readable name |
instance | string | Yes | aws, montino, mac, etc. |
model | string | No | AI model identifier |
role | string | No | orchestrator, specialist, curator, admin |
project_slug | string | No | Auto-create and assign to project |
quoth_agent_register({
agent_name: "deployer",
display_name: "Deployer š",
instance: "montino",
role: "specialist",
project_slug: "deployer-verticals"
})
quoth_agent_update / quoth_agent_remove
Update agent profile or archive/delete an agent.
quoth_agent_list
List all agents with filtering.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | "active" | "inactive" | "archived" | "all" | No | Default: active |
instance | string | No | Filter by instance |
project_id | string | No | Filter by project |
quoth_agent_assign_project / quoth_agent_unassign_project
Manage many-to-many agent-project assignments.
quoth_agent_message
Send a targeted message to another agent with HMAC-SHA256 signing.
| Parameter | Type | Required | Description |
|---|---|---|---|
from | string | No | Sender agent name/UUID (recommended) |
to | string | Yes | Target agent name/UUID |
message | string | Yes | Message content |
type | enum | No | message, task, result, alert, knowledge, curator |
priority | enum | No | low, normal, high, urgent |
channel | string | No | Channel/topic |
reply_to | string | No | Message ID to reply to |
quoth_agent_inbox
Read messages sent to an agent.
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_name | string | No | Agent name |
limit | number | No | Max messages (default: 10) |
status | enum | No | pending, delivered, read, failed, all |
mark_read | boolean | No | Mark as read (default: false) |
quoth_task_create / quoth_task_update
Create and manage structured tasks for agents.
Provisioning Tools
quoth_token_generate
Generate a JWT MCP token for any project. Enables programmatic token rotation and agent provisioning without the dashboard.
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | No | Project UUID |
project_slug | string | No | Or use slug |
label | string | Yes | Token label |
expires_days | number | No | Default: 90 |
quoth_project_provision_agent
One-shot provisioning. Creates project (if needed) + registers agent (if needed) + generates MCP token. Returns everything needed to configure mcporter.
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_name | string | Yes | Agent name (lowercase, hyphens) |
project_slug | string | Yes | Project slug |
display_name | string | No | Human-readable name |
instance | string | Yes | aws, montino, mac |
model | string | No | Model identifier |
role | string | No | Role |
token_label | string | No | Defaults to "agent-" |
quoth_project_provision_agent({
agent_name: "deployer",
project_slug: "deployer-verticals",
display_name: "Deployer š",
instance: "montino",
model: "anthropic/claude-sonnet-4",
role: "specialist"
})
// Returns: project_id, agent_id, MCP token, mcporter config
Documentation Bootstrap
quoth_genesis
Scans your codebase and generates documentation in phases:
| Parameter | Type | Required | Description |
|---|---|---|---|
depth_level | "minimal" | "standard" | "comprehensive" | No | Default: standard |
focus | "full_scan" | "update_only" | No | Default: full_scan |
language_hint | string | No | Primary language hint |
Cross-Instance Architecture
āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā
ā AWS Agents āāāāāāŗā Quoth Bus āāāāāāŗā Montino ā
ā (morfeo, ā ā (Supabase ā ā Agents ā
ā life) ā ā Realtime) ā ā (deployer, ā
āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā ā ads, echo) ā
āāāāāāāāāāāāāāā
All agents authenticate with their own project-scoped MCP token. Messages are delivered in real-time via Supabase Realtime with HMAC-SHA256 signing for verification.
Priority Levels
| Priority | Use Case |
|---|---|
low | Background tasks |
normal | Regular messages |
high | Important notifications |
urgent | Critical alerts + notification |
Rate Limits
| Tier | Requests/min | Search/day |
|---|---|---|
| Free | 10 | 100 |
| Pro | 60 | 1,000 |
| Enterprise | Unlimited | Unlimited |