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)

ToolPurposeAuth
quoth_guidelinesAdaptive guidelines for coding/review/documentationYes
quoth_search_indexSemantic search across documentationYes
quoth_read_docRead full document contentYes
quoth_propose_updateSubmit documentation updatesEditor+
quoth_list_templatesList available templatesYes
quoth_get_templateFetch template structureYes
quoth_read_chunksFetch specific chunks by IDYes
quoth_list_accountsList available project accountsYes
quoth_switch_accountSwitch active project contextYes

Project Management Tools (6)

ToolPurposeAuth
quoth_project_listList all projects in organizationYes
quoth_project_readRead project detailsYes
quoth_project_createCreate a new projectAdmin
quoth_project_updateUpdate project settingsAdmin
quoth_project_deleteDelete a project (with confirmation)Admin
quoth_reindexReindex project documentationAdmin

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

ToolPurposeAuth
quoth_agent_registerRegister a new agent (auto-creates project)Yes
quoth_agent_updateUpdate agent profile/statusYes
quoth_agent_removeArchive or delete an agentYes
quoth_agent_listList all agents in organizationYes
quoth_agent_assign_projectAssign agent to a projectYes
quoth_agent_unassign_projectRemove agent from projectYes
quoth_agent_messageSend message to another agent (HMAC signed)Yes
quoth_agent_inboxRead agent's message inboxYes
quoth_task_createCreate task for an agentYes
quoth_task_updateUpdate task status/resultYes

Provisioning Tools (2)

ToolPurposeAuth
quoth_token_generateGenerate JWT MCP tokens programmaticallyAdmin
quoth_project_provision_agentOne-shot: create project + register agent + generate tokenAdmin

Documentation Bootstrap (1)

ToolPurposeAuth
quoth_genesisPhased codebase scanning and documentation bootstrappingYes

Knowledge Base Tools

quoth_guidelines

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

Parameters

ParameterTypeRequiredDescription
mode"code" | "review" | "document"YesTask mode
fullbooleanNoFull guidelines (~500 tokens) vs compact (~150 tokens)

quoth_search_index

Semantic vector search across your knowledge base.

Parameters

ParameterTypeRequiredDescription
querystringYesNatural language search query (max 1000 chars)
scope"project" | "shared" | "org"NoSearch 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.

ParameterTypeRequiredDescription
doc_idstringYesDocument title or path
scope"project" | "org"NoDefault: project

quoth_propose_update

Submit a documentation update proposal with evidence. Requires editor+ role.

ParameterTypeRequiredDescription
doc_idstringYesDocument to update
new_contentstringYesProposed new content (full markdown)
evidence_snippetstringYesCode or commit reference
reasoningstringYesWhy this update is needed
visibility"project" | "shared"NoDefault: project

quoth_list_templates / quoth_get_template

List and fetch document templates by category.

ParameterTypeRequiredDescription
category"all" | "architecture" | "patterns" | "contracts"NoDefault: all

quoth_read_chunks

Fetch specific chunks by ID. Token-efficient for retrieving only needed sections.

ParameterTypeRequiredDescription
chunk_idsstring[]YesArray 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.

ParameterTypeRequiredDescription
slugstringYesProject slug (lowercase, hyphens)
github_repostringNoGitHub repo URL
is_publicbooleanNoDefault: false

quoth_project_list

List all projects in your organization.

ParameterTypeRequiredDescription
organization_idstringNoFilter by org (uses current by default)

quoth_project_read

Get details of a specific project.

ParameterTypeRequiredDescription
project_idstringNoProject UUID

quoth_project_update

Update project settings (slug, repo, visibility, approval requirements).

ParameterTypeRequiredDescription
project_idstringNoProject UUID
slugstringNoNew slug
github_repostringNoNew repo URL
is_publicbooleanNoVisibility
require_approvalbooleanNoRequire approval for updates

quoth_project_delete

Delete a project. Requires slug confirmation for safety.

ParameterTypeRequiredDescription
project_idstringYesProject UUID
confirm_slugstringYesType the slug to confirm

quoth_reindex

Reindex all documentation for a project (regenerates embeddings).

ParameterTypeRequiredDescription
project_idstringNoUses 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.

ParameterTypeRequiredDescription
agent_namestringYesUnique name (lowercase, hyphens)
display_namestringNoHuman-readable name
instancestringYesaws, montino, mac, etc.
modelstringNoAI model identifier
rolestringNoorchestrator, specialist, curator, admin
project_slugstringNoAuto-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.

ParameterTypeRequiredDescription
status"active" | "inactive" | "archived" | "all"NoDefault: active
instancestringNoFilter by instance
project_idstringNoFilter 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.

ParameterTypeRequiredDescription
fromstringNoSender agent name/UUID (recommended)
tostringYesTarget agent name/UUID
messagestringYesMessage content
typeenumNomessage, task, result, alert, knowledge, curator
priorityenumNolow, normal, high, urgent
channelstringNoChannel/topic
reply_tostringNoMessage ID to reply to

quoth_agent_inbox

Read messages sent to an agent.

ParameterTypeRequiredDescription
agent_namestringNoAgent name
limitnumberNoMax messages (default: 10)
statusenumNopending, delivered, read, failed, all
mark_readbooleanNoMark 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.

ParameterTypeRequiredDescription
project_idstringNoProject UUID
project_slugstringNoOr use slug
labelstringYesToken label
expires_daysnumberNoDefault: 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.

ParameterTypeRequiredDescription
agent_namestringYesAgent name (lowercase, hyphens)
project_slugstringYesProject slug
display_namestringNoHuman-readable name
instancestringYesaws, montino, mac
modelstringNoModel identifier
rolestringNoRole
token_labelstringNoDefaults 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:

ParameterTypeRequiredDescription
depth_level"minimal" | "standard" | "comprehensive"NoDefault: standard
focus"full_scan" | "update_only"NoDefault: full_scan
language_hintstringNoPrimary 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

PriorityUse Case
lowBackground tasks
normalRegular messages
highImportant notifications
urgentCritical alerts + notification

Rate Limits

TierRequests/minSearch/day
Free10100
Pro601,000
EnterpriseUnlimitedUnlimited