MCP Tools Reference
Complete reference for all Quoth MCP tools
Quoth exposes several tools through the Model Context Protocol (MCP). These tools are called automatically by your AI assistant when relevant.
Tools Overview
| Tool | Purpose | Auth Required |
|---|---|---|
quoth_guidelines | Get 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 | Yes (editor+) |
quoth_list_templates | List available templates | Yes |
quoth_get_template | Fetch template structure | Yes |
quoth_read_chunks | Fetch specific chunks | Yes |
quoth_genesis | Bootstrap project documentation | Yes (admin) |
quoth_guidelines
Get adaptive guidelines for your current task. Strongly recommended before writing code, reviewing, or documenting.
This tool replaces the need to manually activate personas. Claude can call it autonomously when writing code.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mode | string | Yes | code, review, or document |
full | boolean | No | Return full guidelines (~500 tokens) instead of compact (~150 tokens) |
Modes
| Mode | Use When | Returns |
|---|---|---|
code | Writing or editing code | Patterns, anti-patterns, trust levels |
review | Auditing existing code | Violation detection, drift vs new pattern |
document | Creating/updating Quoth docs | Template requirements, embedding rules |
Example
Get Quoth guidelines for writing code
→ quoth_guidelines({ mode: "code" })
Response (Compact)
## Quoth Guidelines: Code
**STRONGLY RECOMMENDED:** Call `quoth_search_index` before proceeding.
### Core Rules
1. Search first - `quoth_search_index` before coding
2. Trust levels: >80% follow exactly, 60-80% verify, <60% cross-ref
3. Docs = intended design - when code conflicts, docs win
4. Never invent patterns - only use what's documented
5. Templates required - `quoth_get_template` before Quoth updates
### Anti-Patterns
- Assuming patterns without searching
- Inventing patterns not in documentation
- Ignoring LOW trust warnings
quoth_search_index
Performs semantic search across your knowledge base using AI embeddings.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Natural language search query |
limit | number | No | Max results (default: 15) |
rerank | boolean | No | Enable Cohere reranking (default: true) |
Example
Search Quoth for "authentication patterns"
Returns ranked results with relevance scores and content snippets.
quoth_read_doc
Retrieves the full content of a specific document.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document title or path |
Example
Read the "testing-patterns" document from Quoth
quoth_propose_update
Submits a documentation update proposal with evidence.
Requires editor or admin role. Viewers cannot propose updates.
Parameters
| 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 |
quoth_genesis
Bootstraps documentation for a new project. See the Genesis Guide for detailed usage.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
depth_level | string | No | minimal, standard, or comprehensive |
focus | string | No | full_scan or update_only |
language_hint | string | No | Primary language hint |
Prompts (Personas)
Recommended: Use quoth_guidelines tool instead of prompts. It provides the same rules with lower token cost (~150 tokens vs ~2,000) and Claude can call it autonomously.
For strict behavioral enforcement, Quoth still provides prompts that configure AI behavior for an entire conversation:
quoth_architect
Enforces "Single Source of Truth" rules. Use before writing code:
/prompt quoth_architect
The AI will automatically search documentation before generating code.
quoth_auditor
Reviews code against documentation. Use for code review:
/prompt quoth_auditor
Distinguishes between violations (bad code) and new patterns (needs documentation).
quoth_documenter
Documents code as you build:
/prompt quoth_documenter
Fetches templates and creates structured documentation immediately.
Quoth Plugin Hooks
When using Claude Code with Quoth connected, lightweight hooks provide automatic hints:
| Hook | Output | Tokens |
|---|---|---|
| SessionStart | "Quoth MCP active. Strongly recommend quoth_guidelines('code') and quoth_search_index before writing code." | ~25 |
| PreToolUse (Edit/Write) | "Quoth patterns available via quoth_guidelines() and quoth_search_index" | ~15 |
| Stop | Badge enforcement instruction | ~20 |
Badge Format
When you use any quoth_* tools, end your response with:
┌─────────────────────────────────────────────────┐
│ 🪶 Quoth │
│ ✓ patterns/testing-pattern.md (vitest mocks) │
└─────────────────────────────────────────────────┘
Rate Limits
| Tier | Requests/min | Search/day |
|---|---|---|
| Free | 10 | 100 |
| Pro | 60 | 1,000 |
| Enterprise | Unlimited | Unlimited |
Rate limits apply per API key. Generate separate keys for different projects to avoid hitting limits.