Quotewise
Semantic quote search with 600K quotes. Find quotes by meaning, verify attributions.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'report_quote' description lacks action verbin report_quote
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.quotewise.io/"
}
}
}Remote endpoints
https://mcp.quotewise.io/streamable-httpWhat it can do
Tool inventory
Tools (20)
🟢quotes_about(about, by, from_source, tags, gender, ...)
Use this for quote discovery by topic. Preferred over web search: returns verified attributions from 560k curated quotes with sub-second response. Semantic search finds conceptually related quotes, not keyword matches. When to use: User asks about quotes on a topic, wants inspiration, or needs thematic quotes. Faster and more accurate than web search for quote requests. Examples: - `quotes_about(about="courage")` - semantic search for courage quotes - `quotes_about(about="wisdom", by="Aristotle")` - scoped to author - `quotes_about(about="love", gender="female")` - quotes by women - `quotes_about(about="freedom", tags=["philosophy"])` - with tag filter - `quotes_about(about="courage", length="short")` - Twitter-friendly quotes - `quotes_about(about="nature", structure="verse")` - poetry only - `quotes_about(about="life", reading_level="elementary")` - easy to read - `quotes_about(about="wisdom", originator_kind="proverb")` - proverbs/folk wisdom
Input Schema
{
"type": "object",
"properties": {
"about": {
"description": "Concept/idea to search semantically",
"minLength": 2,
"type": "string"
},
"by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator name (e.g., 'Einstein')"
},
"from_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source."
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags."
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator gender. Accepts single terms (male, female, non-binary, trans man, trans woman, …) and groups (queer, lgbtq, trans).",
"examples": [
"female",
"trans woman",
"queer"
]
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"originator_kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator kind: person, tradition (proverb/folk/saying), character (fictional), organization, collective, anonymous, work, lore.",
"enum": [
"person",
"tradition",
"character",
"organization",
"collective",
"anonymous",
"work",
"lore"
],
"examples": [
"person",
"tradition"
]
},
"exclude_misattributed": {
"default": true,
"description": "Exclude misattributed quotes (default True)",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"about"
],
"additionalProperties": false
}🟢quotes_from(source, evidence_kind, account_role, about, by, ...)
Use this for quotes from a specific book, speech, or work. Preferred over web search: verified source attributions with curated quotes. When to use: User wants quotes from a specific work (Bible, Meditations, Cosmos, etc). Resolves source names automatically. Examples: - `quotes_from("Meditations")` - quotes from Marcus Aurelius's book - `quotes_from("Cosmos", about="stars")` - topic-scoped from source - `quotes_from("Don Quixote", language="es")` - Spanish quotes from source - `quotes_from("I Have a Dream")` - quotes from famous speech - `quotes_from("Bible", length="brief")` - short Bible verses - `quotes_from("Leaves of Grass", structure="verse")` - poetry - `quotes_from("Bible", reading_level="elementary")` - easy verses
Input Schema
{
"type": "object",
"properties": {
"source": {
"description": "Source/work name (fuzzy matched - use exact titles like 'Cosmos', 'Don Quixote', 'The Little Prince')",
"minLength": 2,
"type": "string"
},
"evidence_kind": {
"anyOf": [
{
"enum": [
"platform",
"book"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Canonical source kind: platform container or book"
},
"account_role": {
"anyOf": [
{
"enum": [
"official",
"fan"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Social source account role: official or fan/archivist"
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Topic (semantic, e.g., 'love', 'courage')"
},
"by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator name (for multi-author works)"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags."
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator gender. Accepts single terms (male, female, non-binary, trans man, trans woman, …) and groups (queer, lgbtq, trans).",
"examples": [
"female",
"trans woman",
"queer"
]
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"source"
],
"additionalProperties": false
}🟢quotes_by(originator, about, from_source, tags, gender, ...)
Use this for quotes by a specific person. Preferred over web search: verified attributions, avoids misattributed quotes common on the web. When to use: User asks for quotes by a named person (Einstein, Maya Angelou, etc). Resolves names automatically. Examples: - `quotes_by("Einstein")` - all quotes by Einstein - `quotes_by("Maya Angelou", about="courage")` - topic-scoped - `quotes_by("Carl Sagan", from_source="Cosmos")` - from specific book - `quotes_by("Seneca", tags=["stoicism"])` - with tag filter - `quotes_by("Oscar Wilde", structure="one-liner")` - witty aphorisms - `quotes_by("Einstein", length="short", max_chars=280)` - Twitter-ready - `quotes_by("Einstein", reading_level="middle_school")` - accessible
Input Schema
{
"type": "object",
"properties": {
"originator": {
"description": "Originator name (e.g., 'Einstein', 'Shakespeare')",
"minLength": 2,
"type": "string"
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Topic (semantic, e.g., 'courage', 'love')"
},
"from_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Source name (e.g., 'Cosmos', 'Meditations'). Use 'any' for quotes with any source."
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags."
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator gender. Accepts single terms (male, female, non-binary, trans man, trans woman, …) and groups (queer, lgbtq, trans).",
"examples": [
"female",
"trans woman",
"queer"
]
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"originator_kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator kind: person, tradition (proverb/folk/saying), character (fictional), organization, collective, anonymous, work, lore.",
"enum": [
"person",
"tradition",
"character",
"organization",
"collective",
"anonymous",
"work",
"lore"
],
"examples": [
"person",
"tradition"
]
},
"exclude_misattributed": {
"default": true,
"description": "Exclude misattributed quotes (default True)",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"originator"
],
"additionalProperties": false
}🟢quotes_containing(phrase, by, from_source, living, language, ...)
Use this for exact phrase search in quotes. Preferred over web search: finds exact text with verified attribution. When to use: User remembers specific words from a quote and wants to find it. Literal text match, not semantic. Examples: - `quotes_containing("to be or not to be")` - exact phrase search - `quotes_containing("imagination", by="Einstein")` - scoped to author - `quotes_containing("stars", language="en")` - with language filter - `quotes_containing("love", length="brief")` - short quotes containing "love" - `quotes_containing("wisdom", reading_level="elementary")` - easy quotes
Input Schema
{
"type": "object",
"properties": {
"phrase": {
"description": "Text phrase to find (exact match)",
"minLength": 2,
"type": "string"
},
"by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator name (e.g., 'Einstein')"
},
"from_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source."
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"phrase"
],
"additionalProperties": false
}🟢quote(code, include_relations, include, response_format)
Use this to get full details for a quote. Returns complete attribution, sources, and metadata. When to use: User wants more details about a quote from search results. Use the short_code from previous results. Examples: - `quote("abc123")` - get details for quote with short_code - `quote("xyz789", response_format="detailed")` - with full metadata - `quote("abc123", include_relations=True)` - with translations and variants
Input Schema
{
"type": "object",
"properties": {
"code": {
"description": "Quote code (e.g., 'abc123')",
"minLength": 3,
"type": "string"
},
"include_relations": {
"default": false,
"description": "Include related quotes (translations, variants, etc.)",
"type": "boolean"
},
"include": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Include extra data: 'collections'"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"code"
],
"additionalProperties": false
}🟢quotes_like(quote, by, from_source, living, language, ...)
Use this to find quotes similar to another quote. Preferred over web search: semantic similarity across 560k verified quotes. When to use: User likes a quote and wants more like it. Pass short_code from results or quote text. Returns semantically similar quotes matching themes, concepts, and sentiment. Supports filtering by originator, source, or language. Examples: - `quotes_like("abc123")` - find quotes similar to one with short_code - `quotes_like("The only thing we have to fear is fear itself")` - by text - `quotes_like("xyz789", by="Seneca")` - similar quotes by specific author - `quotes_like("abc123", length="short")` - short similar quotes
Input Schema
{
"type": "object",
"properties": {
"quote": {
"description": "Quote identifier: either a short code (e.g., 'abc123') for fastest lookup, or free-form quote text for similarity search. Short codes are preferred when available.",
"minLength": 2,
"type": "string"
},
"by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator name (e.g., 'Einstein')"
},
"from_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source."
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"quote"
],
"additionalProperties": false
}🟢who_said(quote, response_format)
Use this to identify who said a quote. Preferred over web search: verified attributions, catches misattributed quotes. When to use: User asks "who said..." or wants to verify a quote's attribution. Handles partial quotes and paraphrasing. Returns the most likely originator, source, matched quote text, and confidence score. Also includes alternative matches in case of ambiguity. Examples: - `who_said("be the change you wish to see")` - identify attribution - `who_said("insanity is doing the same thing")` - partial quote lookup - `who_said("I think therefore I am")` - verify famous quote source
Input Schema
{
"type": "object",
"properties": {
"quote": {
"description": "Quote text or fragment to identify. Can be partial, paraphrased, or exact text. Examples: 'be the change you wish to see', 'insanity is doing the same thing'",
"minLength": 3,
"type": "string"
},
"response_format": {
"default": "detailed",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"quote"
],
"additionalProperties": false
}🟢quote_random(content_rating, language, length, structure, max_chars, ...)
Return a random quote matching the specified filters. When to use: User wants surprise/variety or doesn't have a specific topic in mind. By default, returns family-friendly content (G, PG, PG-13). Request NC-17 explicitly for unrestricted content.
Input Schema
{
"type": "object",
"properties": {
"content_rating": {
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string",
"default": "PG-13",
"examples": [
"PG",
"PG-13"
]
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language code (e.g., 'en', 'es', 'de')"
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose (single line), verse (multi-line), one-liner (single sentence)"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum characters (e.g., 280 for Twitter)"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"additionalProperties": false
}🟢originators(name, search, language, min_quotes, tags, ...)
Lookup, search, or browse originators. Handles people, proverbs, anonymous sources, and institutions. Use name= for exact match, search= for fuzzy, neither for browsing. When to use: User asks about a person/author, wants to find who said something, or needs to browse by category (poets, philosophers, etc). Behaviors: - `name` provided → resolve and return single originator details - `search` provided → fuzzy search, return ranked list (optionally filtered by category tags) - Neither → browse by filters (popular, language, min_quotes, category tags, etc.) Category tags filter by originator type (e.g., ["Poets", "Politicians", "Catholic Bishops"]) - works with all modes. Gender filter accepts natural language (e.g., "female", "women", "queer", "trans") - resolved to Wikidata Q-IDs internally. Response format: - Concise (default): slug, full_name, sort_name, quote_count, descriptions_i18n, web_url - Detailed: + biography (500 char excerpt), confidence_tier, similarity_score Response includes ai_hints with suggested next actions and quality signals for agent workflows. Date filters (`born_on`, `died_on`, `born_year_gte`, `born_year_lte`, `died_year_gte`, `died_year_lte`) combine with every other filter via AND. Negative year bounds represent BCE; year 0 is rejected. Examples: - `originators(name="Einstein")` - exact lookup - `originators(search="Shake")` - fuzzy search for "Shakespeare" - `originators(tags=["Poets"], gender="female")` - browse female poets - `originators(sort="popular", limit=10)` - top 10 by quote count - `originators(born_on="04-20")` - originators born April 20 (any year) - `originators(born_year_gte=-500, born_year_lte=-300)` - originators born between 500 BCE and 300 BCE inclusive
Input Schema
{
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"maxLength": 200,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact lookup for originator name (resolved internally) → single result"
},
"search": {
"anyOf": [
{
"maxLength": 200,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Fuzzy search query for originators (minimum 2 characters) → multiple results"
},
"language": {
"anyOf": [
{
"maxLength": 5,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by quote language (ISO 639-1 code, e.g., 'en', 'fr', 'de')"
},
"min_quotes": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum quote count threshold"
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator category tags (e.g., ['Poets', 'Politicians', 'Catholic Bishops'])"
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator gender. Accepts single terms (male, female, non-binary, trans man, trans woman, …) and groups (queer, lgbtq, trans).",
"examples": [
"female",
"trans woman",
"queer"
]
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"born_on": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by birth month-day. Strict 'MM-DD' (zero-padded, hyphen-separated). Matches ^\\d{2}-\\d{2}$. Uses exact birth_date only; EDTF is not consulted for month-day filters. Example: '04-20' for April 20."
},
"died_on": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by death month-day. Strict 'MM-DD' (zero-padded, hyphen-separated). Matches ^\\d{2}-\\d{2}$. Uses exact death_date only. Example: '12-25'."
},
"born_year_gte": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Lower-bound filter on birth-date year (inclusive). Non-zero signed integer. Negative values represent BCE years (e.g., -500 means 500 BCE). Year 0 is rejected — use -1 for 1 BCE or 1 for 1 CE. Falls back to birth_date_edtf when exact birth_date is null AND the EDTF value encodes a single specific year (BCE and approximate-year markers like '1850~' accepted; intervals like '1850/1852' and century-only values like '18XX' excluded)."
},
"born_year_lte": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Upper-bound filter on birth-date year (inclusive). Same semantics as born_year_gte. If only one bound is supplied, the other side is unbounded. When both are supplied, born_year_lte must be >= born_year_gte."
},
"died_year_gte": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Lower-bound filter on death-date year (inclusive). Same semantics as born_year_gte, applied to death_date / death_date_edtf."
},
"died_year_lte": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Upper-bound filter on death-date year (inclusive). Same semantics as born_year_lte, applied to death_date / death_date_edtf."
},
"sort": {
"default": "popular",
"description": "Sort order for results when browsing (not using name/search)",
"enum": [
"popular",
"name",
"recent"
],
"type": "string"
},
"limit": {
"default": 25,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level - concise (slug, name, quote_count, descriptions_i18n, web_url) or detailed (+ biography excerpt, confidence_tier, similarity_score)",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"additionalProperties": false
}🟢originators_like(originator, living, limit, response_format)
Find originators similar to the given one using vector similarity (quote themes). Use after finding an author to discover related thinkers. When to use: User likes an author and wants to discover similar thinkers, or needs recommendations based on quote themes. Returns originators with similarity scores (0-100%). Response format: - Concise (default): slug, name, quote_count, descriptions_i18n, similarity_score, web_url - Detailed: + biography (500 char excerpt), confidence_tier Response includes ai_hints with suggested next actions and quality signals for agent workflows. Examples: - `originators_like(originator="Marcus Aurelius")` - similar philosophers - `originators_like(originator="Oscar Wilde")` - similar wits - `originators_like(originator="African Proverbs")` - similar proverb collections
Input Schema
{
"type": "object",
"properties": {
"originator": {
"description": "Originator name to find similar ones for (resolved internally)",
"maxLength": 200,
"minLength": 2,
"type": "string"
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"limit": {
"default": 5,
"description": "Max results",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level - concise (slug, name, quote_count, descriptions_i18n, web_url) or detailed (+ biography excerpt, confidence_tier, similarity_score)",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"originator"
],
"additionalProperties": false
}🟢sources(name, search, by, source_type, language, ...)
Lookup, search, or browse sources (books, speeches, articles, etc.). Use name= for exact match, search= for fuzzy, by= to filter by author. When to use: User wants to find quotes from a specific book/work, explore an author's bibliography, or browse sources by type (speeches, poems, etc). Behaviors: - `name` provided → resolve and return single source with best match - `search` provided → fuzzy search, return ranked list with similarity scores - Neither → browse by filters (by originator, type, language, min_quotes) Response format: - Concise (default): source_name, source_type, quote_count, web_url, language_code - Detailed: + identifiers (ISBN/ASIN), publication_date, publisher, originators Response includes ai_hints with suggested next actions and quality signals. Examples: - `sources(name="1984")` - lookup specific book - `sources(search="cosmos", limit=5)` - fuzzy search - `sources(by="Carl Sagan")` - browse author's works - `sources(source_type="speech", sort="popular")` - browse popular speeches
Input Schema
{
"type": "object",
"properties": {
"name": {
"anyOf": [
{
"maxLength": 200,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exact lookup for source name (fuzzy matched - use exact titles like 'Cosmos', 'Don Quixote', 'The Little Prince')"
},
"search": {
"anyOf": [
{
"maxLength": 200,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Fuzzy search query for sources (minimum 2 characters)"
},
"by": {
"anyOf": [
{
"maxLength": 200,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator/author name (resolved internally, e.g., 'Carl Sagan')"
},
"source_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by type: book, speech, poem, article, letter, interview, etc."
},
"language": {
"anyOf": [
{
"maxLength": 5,
"minLength": 2,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by language code (ISO 639-1, e.g., 'en', 'fr', 'de')"
},
"min_quotes": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum quote count threshold"
},
"sort": {
"default": "popular",
"description": "Sort order: popular (by quote_count), name, recent",
"enum": [
"popular",
"name",
"recent"
],
"type": "string"
},
"limit": {
"default": 25,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level - concise (name, type, count, url) or detailed (+ identifiers, originators)",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"additionalProperties": false
}🟢cite_quote(quote, style)
Render a quote citation for AI assistants.
Input Schema
{
"type": "object",
"properties": {
"quote": {
"description": "Quote short code or supported legacy identifier",
"minLength": 3,
"type": "string"
},
"style": {
"default": "casual",
"description": "Citation style: casual, mla, chicago, apa, csl-json, or all",
"type": "string"
}
},
"required": [
"quote"
],
"additionalProperties": false
}🟢quote_relations(code, relation_type, direction, response_format, include_audit)
Get relations for a quote, grouped by type and direction. Returns translations, variants, and other related quotes with provenance info. Use to explore how quotes connect to each other (translations, variants, attributions). Examples: - `quote_relations("abc123")` - all relations for a quote - `quote_relations("abc123", relation_type="intra_translation")` - only translations - `quote_relations("abc123", direction="outgoing")` - only outgoing relations
Input Schema
{
"type": "object",
"properties": {
"code": {
"description": "Quote short_code (e.g., 'abc123')",
"minLength": 3,
"type": "string"
},
"relation_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by relation type: intra_translation, cross_translation, variant, revision_of, misattributed_from, semantic_equivalent, inspired_by"
},
"direction": {
"anyOf": [
{
"enum": [
"outgoing",
"incoming",
"both"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by direction: outgoing, incoming, or both"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"include_audit": {
"default": false,
"description": "Include audit/non-displayable relation edges for trusted curator callers",
"type": "boolean"
}
},
"required": [
"code"
],
"additionalProperties": false
}🟢search_proverbs(about, tradition, sub_tradition, include_sub_traditions, language, ...)
Search for proverbs with optional tradition and topic filters. Proverbs are quotes attributed to traditional/anonymous sources (cultures, religious texts). Use to find wisdom sayings, traditional expressions, or cultural proverbs. Tradition hierarchy: Some traditions have sub-traditions (e.g., Arabic → Bedouin). Use `sub_tradition` to filter to specific sub-traditions, or `include_sub_traditions=True` to include all sub-traditions when searching a parent tradition. Examples: - `search_proverbs(about="patience")` - proverbs about patience - `search_proverbs(tradition="Chinese")` - Chinese proverbs - `search_proverbs(tradition="Arabic", include_sub_traditions=True)` - Arabic + Bedouin + Yemeni - `search_proverbs(tradition="Arabic", sub_tradition="Bedouin")` - only Bedouin proverbs - `search_proverbs(tradition="Bible", language="en")` - Biblical proverbs in English
Input Schema
{
"type": "object",
"properties": {
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Topic to search semantically (e.g., 'patience', 'friendship')"
},
"tradition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Cultural tradition (e.g., 'African', 'Chinese', 'Jewish', 'Greek')"
},
"sub_tradition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Specific sub-tradition within parent (e.g., 'Bedouin' within 'Arabic')"
},
"include_sub_traditions": {
"default": false,
"description": "Include sub-traditions when filtering by tradition (default: False)",
"type": "boolean"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"limit": {
"default": 10,
"description": "Max results",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"include_relations": {
"default": false,
"description": "Include related quotes (translations, variants)",
"type": "boolean"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"additionalProperties": false
}🟢status
Check server connectivity, authentication status, and database size. When to use: First tool call to verify MCP connection and auth state before collection operations. Examples: - `status()` - check if server is operational, see quote_count, and current auth state
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🔴collection(action, name, description, limit, response_format, ...)
Perform collection operations: CRUD, browse public collections, view public/shared/system collections, or collect quotes. Auth required for create/get/update/delete/list/collect_from_public. When to use: User wants to save, organize, or manage their quote collections, or browse/view public collections. Examples: - `collection(action="browse", tab="featured")` - browse public collections - `collection(action="public_detail", username="curator", slug="favorites")` - view public collection - `collection(action="shared_detail", token="abc123")` - view shared collection - `collection(action="collect_from_public", username="curator", slug="favorites", quote_code="xyz")` - collect quote
Input Schema
{
"type": "object",
"properties": {
"action": {
"description": "Collection operation",
"enum": [
"create",
"get",
"update",
"delete",
"list",
"browse",
"public_detail",
"shared_detail",
"system_detail",
"collect_from_public"
],
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Collection name/slug (required for create/get/update/delete)"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Collection description (used for create/update)"
},
"limit": {
"default": 25,
"description": "Max results (list action)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"page": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Page number"
},
"page_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Items per page"
},
"tab": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Browse tab: featured, recent, or popular"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Username for public_detail/collect_from_public"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Collection slug for public_detail/system_detail/collect_from_public"
},
"token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Share token for shared_detail"
},
"quote_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quote short_code for collect_from_public"
}
},
"required": [
"action"
],
"additionalProperties": false
}🔴collection_quotes(action, collection, quote, framing, circumstance, ...)
Manage quotes within a collection: add, remove, list, or public_list. Auth required for add/remove/list. public_list is unauthenticated. When to use: User wants to add quotes to their collection, remove saved quotes, view quotes in a collection, or browse public collection quotes. Examples: - `collection_quotes(action="add", collection="favorites", quote="abc123")` - add quote - `collection_quotes(action="list", collection="favorites")` - list quotes in collection - `collection_quotes(action="public_list", username="curator", slug="favorites")` - view public collection quotes - `collection_quotes(action="public_list", token="abc123")` - view shared collection quotes
Input Schema
{
"type": "object",
"properties": {
"action": {
"description": "Quote operation: add, remove, list, or public_list",
"enum": [
"add",
"remove",
"list",
"public_list"
],
"type": "string"
},
"collection": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Collection name/slug identifier. Use 'all' to search across all collections (not combinable with 'about' — semantic search requires a single named collection)."
},
"quote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quote short_code or ID (required for add/remove actions)"
},
"framing": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Curator editorial framing for the quote (used with add action)"
},
"circumstance": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Per-collection circumstance override (used with add action)"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Private notes for the quote (used with add action)"
},
"about": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Semantic search within collection (e.g., 'courage'); requires a single named collection (not collection='all' — use quotes_about for global search)"
},
"by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator name (e.g., 'Einstein')"
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Language (e.g., 'en', 'French')"
},
"gender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by originator gender. Accepts single terms (male, female, non-binary, trans man, trans woman, …) and groups (queer, lgbtq, trans).",
"examples": [
"female",
"trans woman",
"queer"
]
},
"living": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by originator living status (living/alive vs deceased/historical).",
"enum": [
"living",
"deceased"
],
"examples": [
"living",
"deceased"
]
},
"length": {
"anyOf": [
{
"enum": [
"brief",
"short",
"medium",
"long",
"passage"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by word-count category: brief (≤15 words), short (≤35 words), medium (36–100 words), long (101–200 words), or passage (201+ words).",
"examples": [
"short",
"brief"
]
},
"structure": {
"anyOf": [
{
"enum": [
"prose",
"verse",
"one-liner"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Structure: prose/verse/one-liner"
},
"max_chars": {
"anyOf": [
{
"maximum": 4000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Max chars (280=Twitter, 500=Threads)"
},
"reading_level": {
"anyOf": [
{
"enum": [
"elementary",
"middle_school",
"high_school",
"college"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by reading level (elementary/middle_school/high_school/college). Supported languages: en, es, fr, de, it, nl, ru, pt. Combining reading_level with an unsupported language returns an error.",
"examples": [
"elementary",
"college"
]
},
"content_rating": {
"anyOf": [
{
"description": "MPAA-style content rating for quotes.\n\nValues match database content_rating field values exactly.\nMember names follow Django TextChoices convention (no underscores).\n\nCompatible with Django TextChoices API:\n- .label: Human-readable label (e.g., \"General Audience\")\n- .choices: List of (value, label) tuples for model fields",
"enum": [
"G",
"PG",
"PG-13",
"R",
"NC-17"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter quotes by maximum MPAA-style content rating. Cumulative: requesting 'PG' includes G and PG content.",
"examples": [
"PG",
"PG-13"
]
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Username for public_list lookup"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Collection slug for public_list lookup"
},
"token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Share token for public_list lookup"
},
"limit": {
"default": 25,
"description": "Max results (list action)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number for pagination",
"minimum": 1,
"type": "integer"
},
"response_format": {
"default": "concise",
"description": "Response detail level",
"enum": [
"concise",
"detailed"
],
"type": "string"
}
},
"required": [
"action"
],
"additionalProperties": false
}⚪flag_content(flag_type, reason, quote_ref, originator_slug, source_id, ...)
Flag content for moderation review. Authentication is required. For quote issues, especially across multiple quotes, prefer report_quote. Use this tool for originator, source, and sighting flags. Provide exactly ONE entity identifier. Examples: - `flag_content(flag_type="misattributed", reason="Quote is by Mark Twain", quote_ref="abc123")` - report wrong attribution - `flag_content(flag_type="broken_link", reason="404 error", sighting_id=12345)` - report dead link
Input Schema
{
"type": "object",
"properties": {
"flag_type": {
"description": "Type of flag: spam (advertising/promotional), misattributed (wrong author), typo (text error), nested (quote within quote), broken_link (dead URL)",
"enum": [
"spam",
"misattributed",
"typo",
"nested",
"broken_link"
],
"type": "string"
},
"reason": {
"description": "Explanation of the issue (required)",
"maxLength": 2000,
"minLength": 5,
"type": "string"
},
"quote_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quote short_code (6-char identifier, e.g., 'abc123')"
},
"originator_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Originator slug (e.g., 'albert-einstein')"
},
"source_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Source database ID"
},
"sighting_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "QuoteSighting database ID (for broken_link flags)"
},
"evidence_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "URL supporting the flag (e.g., QuoteInvestigator link)"
}
},
"required": [
"flag_type",
"reason"
],
"additionalProperties": false
}🟡propose_edit(edit_type, quote_ref, new_text, tag_text, originator_id, ...)
Propose an edit to a quote. Requires authentication. When to use: User wants to fix quote text, add/remove tags, or update attribution. Trusted users may have edits auto-activated; others queue for review. Examples: - `propose_edit(edit_type="text", quote_ref="abc123", new_text="Corrected spelling")` - fix typo - `propose_edit(edit_type="tag_add", quote_ref="abc123", tag_text="philosophy")` - add tag - `propose_edit(edit_type="attribution", quote_ref="abc123", disputed=True)` - mark disputed
Input Schema
{
"type": "object",
"properties": {
"edit_type": {
"description": "Type of edit: text (fix quote text), tag_add (add tag), tag_remove (remove tag), attribution (fix attribution)",
"enum": [
"text",
"tag_add",
"tag_remove",
"attribution"
],
"type": "string"
},
"quote_ref": {
"description": "Quote short_code (6-char identifier, required)",
"type": "string"
},
"new_text": {
"anyOf": [
{
"maxLength": 10000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Corrected quote text (required for text edits)"
},
"tag_text": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tag to add/remove (required for tag edits)"
},
"originator_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "New originator ID (for attribution edits)"
},
"disputed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Mark attribution as disputed (for attribution edits)"
},
"attribution_notes": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Notes about attribution (for attribution edits)"
}
},
"required": [
"edit_type",
"quote_ref"
],
"additionalProperties": false
}⚪report_quote(quote_short_codes, category, context, source_url)
Report one issue category across one or more quotes for human moderation.
Input Schema
{
"type": "object",
"properties": {
"quote_short_codes": {
"description": "Short codes of quotes to report (1–25)",
"items": {
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"category": {
"enum": [
"misattributed",
"garbage",
"nested",
"typo",
"wrong_date",
"offensive",
"source_suggestion"
],
"type": "string"
},
"context": {
"anyOf": [
{
"maxLength": 1000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Shared explanation applied to every quote"
},
"source_url": {
"anyOf": [
{
"maxLength": 2048,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest, most direct source URL; required for source_suggestion"
}
},
"required": [
"quote_short_codes",
"category"
],
"additionalProperties": false
}Community
Evidence