MCP Tools Reference

name

Exact lookup. Returns single best match. Use when you know the exact entity name.

search

Fuzzy search. Returns ranked list. Use for partial names or uncertain spelling.

Neither

Browse mode. Returns filtered list based on other parameters.

response_format

"concise" (default) or "detailed". Concise returns essential fields only. Use concise for token efficiency; detailed when you need full metadata.

limit

Max results. Range: 1-50 for search, 1-100 for list operations. Default: 10.

Cost Impact: For discovery tools (quotes_about, quotes_by, quotes_containing, quotes_like, quote), requesting response_format="detailed" adds +1 credit to the base cost. Detailed responses include source attribution, tags, and attribution type—essential for citations but not needed for quick lookups.

language

ISO 639-1 code ('en', 'fr', 'de', 'es').

living

"living" or "deceased". Resolved from Wikidata birth/death dates.

gender

Natural language: "male", "female", "non-binary", "trans", "queer". Aliases supported (e.g., "woman", "nb", "lgbtq"). Resolved to Wikidata Q-IDs.

min_quotes

Minimum quote count threshold (integer ≥1). Use to find well-represented authors.

tags

Profession/category tags. Examples: ['Poets', 'Scientists', 'Nobel Laureates', 'Politicians']. Case-insensitive, fuzzy-matched. OR logic within tags.

sort

"popular" (by quote count), "name" (alphabetical), "recent" (newest).

length

"brief" (1-15 words), "short" (1-35), "medium" (36-100), "long" (101-200), "passage" (201+).

structure

"prose" (single line), "verse" (2+ lines), "one-liner" (1 sentence).

reading_level

"easy", "medium", "hard". Based on Flesch Reading Ease score.

content_rating

"family-friendly" (G/PG), "mature" (PG-13/R), "explicit" (NC-17). MPAA-style ratings from Perspective API.

max_chars

Maximum character count (e.g., 280 for Twitter/X compatibility).

Used by: quotes_about, quotes_by, quotes_from, quotes_like, quotes_containing

action

Mode selector. CRUD: "create", "get", "update", "delete", "list". Membership: "add", "remove", "list".

Each action requires specific additional parameters. See individual tool docs.

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

Parameters

about required string

Concept/idea to search semantically

by string

Originator name (e.g., 'Einstein')

from_source string

Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source.

tags array

Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags.

gender string

Originator gender (e.g., 'female', 'male', 'non-binary', 'trans', 'queer')

living string

Originator living status (e.g., 'living', 'deceased')

language string

Language (e.g., 'en', 'French')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

originator required string

Originator name (e.g., 'Einstein', 'Shakespeare')

about string

Topic (semantic, e.g., 'courage', 'love')

from_source string

Source name (e.g., 'Cosmos', 'Meditations'). Use 'any' for quotes with any source.

tags array

Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags.

gender string

Originator gender (e.g., 'female', 'male', 'non-binary', 'trans', 'queer')

living string

Originator living status (e.g., 'living', 'deceased')

language string

Language (e.g., 'en', 'French')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

phrase required string

Text phrase to find (exact match)

by string

Originator name (e.g., 'Einstein')

from_source string

Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source.

living string

Originator living status (e.g., 'living', 'deceased')

language string

Language (e.g., 'en', 'French')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

code required string

Quote code (e.g., 'abc123')

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

quote required string

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.

by string

Originator name (e.g., 'Einstein')

from_source string

Source name (e.g., 'Cosmos'). Use 'any' for quotes with any source.

living string

Originator living status (e.g., 'living', 'deceased')

language string

Language (e.g., 'en', 'French')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level

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.

Parameters

content_rating any

Maximum content rating: G, PG, PG-13, R, or NC-17

language string

Language code (e.g., 'en', 'es', 'de')

length string

Length: brief (≤15 words), short (≤35), medium (36-100), long (101-200), passage (201+)

structure string

Structure: prose (single line), verse (multi-line), one-liner (single sentence)

max_chars integer

Maximum characters (e.g., 280 for Twitter)

response_format enum['concise', 'detailed']

Response detail level

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.

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

Parameters

name string

Exact lookup for originator name (resolved internally) → single result

search string

Fuzzy search query for originators (minimum 2 characters) → multiple results

language string

Filter by quote language (ISO 639-1 code, e.g., 'en', 'fr', 'de')

min_quotes integer

Minimum quote count threshold

tags array

Filter by originator category tags (e.g., ['Poets', 'Politicians', 'Catholic Bishops'])

gender string

Filter by gender (e.g., 'female', 'male', 'non-binary', 'trans', 'queer', 'lgbtq')

living string

Filter by living status (e.g., 'living', 'deceased')

sort enum['popular', 'name', 'recent']

Sort order for results when browsing (not using name/search)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level - concise (slug, name, quote_count, descriptions_i18n, web_url) or detailed (+ biography excerpt, confidence_tier, similarity_score)

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

Parameters

originator required string

Originator name to find similar ones for (resolved internally)

living string

Filter similar originators by living status (e.g., 'living', 'deceased')

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level - concise (slug, name, quote_count, descriptions_i18n, web_url) or detailed (+ biography excerpt, confidence_tier, similarity_score)

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

Parameters

source required string

Source/work name (fuzzy matched - use exact titles like 'Cosmos', 'Don Quixote', 'The Little Prince')

about string

Topic (semantic, e.g., 'love', 'courage')

by string

Originator name (for multi-author works)

tags array

Tag names (e.g., ['philosophy']). Use ['any'] for quotes with any tags.

gender string

Originator gender (e.g., 'female', 'male', 'non-binary', 'trans', 'queer')

living string

Originator living status (e.g., 'living', 'deceased')

language string

Language (e.g., 'en', 'French')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

quote required string

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'

response_format enum['concise', 'detailed']

Response detail level

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

Parameters

name string

Exact lookup for source name (fuzzy matched - use exact titles like 'Cosmos', 'Don Quixote', 'The Little Prince')

search string

Fuzzy search query for sources (minimum 2 characters)

by string

Filter by originator/author name (resolved internally, e.g., 'Carl Sagan')

source_type string

Filter by type: book, speech, poem, article, letter, interview, etc.

language string

Filter by language code (ISO 639-1, e.g., 'en', 'fr', 'de')

min_quotes integer

Minimum quote count threshold

sort enum['popular', 'name', 'recent']

Sort order: popular (by quote_count), name, recent

limit integer

Max results

response_format enum['concise', 'detailed']

Response detail level - concise (name, type, count, url) or detailed (+ identifiers, originators)

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

No parameters

Perform collection operations: create, get, update, delete, or list collections. Requires authentication. Actions: create/get/update/delete require name; list returns all.

When to use: User wants to save, organize, or manage their quote collections. Requires authentication via status() first.

Examples

• collection(action="create", name="favorites") — create collection
• collection(action="get", name="favorites") — get collection details
• collection(action="list") — list all user collections
• collection(action="delete", name="old-quotes") — delete collection

Parameters

action required enum['create', 'get', 'update', 'delete', 'list']

Collection operation: create, get, update, delete, or list

name string

Collection name/slug (required for create/get/update/delete)

description string

Collection description (used for create/update)

limit integer

Max results (list action)

response_format enum['concise', 'detailed']

Response detail level

page integer

(ignored)

Manage quotes within a collection: add, remove, or list quotes. Requires authentication. Actions: add/remove require quote short_code; list returns all.

When to use: User wants to add quotes to their collection, remove saved quotes, or view quotes in a collection.

Examples

• collection_quotes(action="add", collection="favorites", quote="abc123") — add quote
• collection_quotes(action="list", collection="favorites") — list quotes in collection
• collection_quotes(action="remove", collection="favorites", quote="abc123") — remove quote
• collection_quotes(action="add", collection="study", quote="xyz789", notes="Review later") — with notes
• collection_quotes(action="list", collection="favorites", by="Einstein") — filter by originator
• collection_quotes(action="list", collection="all", about="courage") — semantic search across all collections
• collection_quotes(action="list", collection="favorites", length="short", max_chars=280) — Twitter-friendly

Parameters

action required enum['add', 'remove', 'list']

Quote operation: add, remove, or list quotes in collection

collection required string

Collection name/slug identifier. Use 'all' to search across all collections.

quote string

Quote short_code or ID (required for add/remove actions)

context string

Public context for the quote (used with add action)

notes string

Private notes for the quote (used with add action)

about string

Semantic search within collection (e.g., 'courage')

by string

Filter by originator name (e.g., 'Einstein')

language string

Filter by language (e.g., 'en', 'French')

gender string

Filter by originator gender (e.g., 'female', 'male', 'non-binary')

living string

Filter by originator living status (e.g., 'living', 'deceased')

length string

Quote length: brief/short/medium/long/passage

structure string

Structure: prose/verse/one-liner

max_chars integer

Max chars (280=Twitter, 500=Threads)

reading_level string

Reading level: elementary/middle_school/high_school/college

content_rating any

Max rating: G/PG/PG-13/R (cumulative)

limit integer

Max results (list action)

page integer

Page number for pagination

response_format enum['concise', 'detailed']

Response detail level