# Quotable API MCP

> The Quotable API gives your agent direct access to thousands of famous quotes, author biographies, and thematic tags. Need a quote about technology? Search it by keyword or list all available tags first. You can audit entire author profiles and pull random lines instantly—no need to visit any external quote website.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** quotes, literary-data, content-generation, api-integration, random-data

## Description

This server hooks your agent directly into a massive library of quotes, author bios, and thematic tags. You'll use it to pull verified data points without ever leaving your workflow or touching an external website.

Need inspiration? Your agent can find any quote matching specific words or whole phrases by running `search_quotes`. Or maybe you just want a wild card—call `get_random_quote` for a single, random line from the entire database. If you decide you need to filter that random pick, `get_random_quote` lets you optionally narrow it down using a specific tag or author name.

Want to know what themes are available? Use `list_quote_tags`; it shows every unique quote tag and tells you exactly how many quotes use each one. Before you dive into authors, run `list_quote_authors`. This pulls a full directory of every writer in the database along with their descriptions.

When you find an author you like, you can dig deeper. Pass that author's unique slug to `get_author_details`, and it returns their complete profile—you'll get all the details and the full bio they wrote.

It’s simple: if you need to know what’s going on with the connection, run `check_api_status` to confirm that the Quotable API is actually running and ready for calls. You've got direct access to everything here.

## Tools

### check_api_status
Confirms if the Quotable API service is currently running and available for calls.

### get_author_details
Retrieves a full biography and details for a specific author using their unique slug.

### get_random_quote
Pulls a random quote, optionally filtering the result by a tag or an author's name.

### list_quote_authors
Outputs a list of every available author in the database along with their descriptions.

### list_quote_tags
Lists all unique quote tags and provides a count for how many quotes use each tag.

### search_quotes
Searches the database content, returning quotes that contain specified keywords or phrases.

## Prompt Examples

**Prompt:** 
```
Get a random quote about 'wisdom' using Quotable.
```

**Response:** 
```
I've retrieved a random quote about wisdom! It's by [Author]: "[Quote content]". Would you like the author's biography or other quotes with this tag?
```

**Prompt:** 
```
Search for quotes by 'Albert Einstein'.
```

**Response:** 
```
I've identified 10 quotes by Albert Einstein. Notable entries include his thoughts on imagination and logic. I can provide the full details and tags for each of these quotes if you'd like.
```

**Prompt:** 
```
List all available quote tags.
```

**Response:** 
```
I've scanned the tag catalog. There are over 50 tags available, including 'technology', 'success', 'love', and 'life'. I can help you retrieve a random quote for any of these specific themes.
```

## Capabilities

### Search Quotes by Keyword
The agent finds quotes that match specific words or phrases you give it.

### Get Random Quote
It pulls a single, random quote from the entire database. You can optionally filter this by tag or author.

### List Available Tags
The agent shows you every existing quote tag and how many quotes are attached to it.

### Audit Author Biographies
You pass an author's unique slug, and the tool returns their complete profile details and bio.

### List All Authors
The agent provides a full list of every author in the database with their descriptions.

### Check Server Status
It validates if the Quotable API connection is currently operational and ready to use.

## Use Cases

### Content Gap Analysis
A social media manager notices their recent posts are all about 'success.' They run `list_quote_tags` to see what's missing. Seeing that 'failure' has a high tag count, they use `search_quotes` with 'failure' and generate content on the topic.

### Drafting a Thematic Article
A technical writer is writing about AI ethics. They first run `list_quote_tags` to ensure 'technology' is covered, then use `search_quotes` with keywords like 'ethics' and 'future' to gather multiple supporting quotes for the article body.

### Verifying an Expert Source
A researcher finds a quote attributed to someone unfamiliar. They immediately use `get_author_details` with the author's slug to confirm the person’s background and credentials before citing it in their paper.

### Quick Content Dump
A team lead is brainstorming ideas for a client presentation. They ask their agent for 'three quotes about wisdom.' The agent runs `get_random_quote` three times and delivers the raw material instantly, saving minutes of manual searching.

## Benefits

- Stop guessing what content resonates. Run `list_quote_tags` to see the exact thematic categories (like 'technology' or 'leadership') that other users are using, letting you build targeted campaigns.
- Need background info on a writer? Instead of searching Google, use `get_author_details`. You pass the slug and instantly get their full biography without leaving your agent workflow.
- Building content fast requires quick ideas. Use `get_random_quote` to drop in fresh material for drafts or social posts when you're stuck on a line.
- When you need to fact-check a claim, use `search_quotes`. You just provide the keyword, and it returns verified quotes with their sources.
- Forget building custom search forms. The API handles all metadata—you can run `list_quote_authors` and get a clean list of every source available for your content calendar.

## How It Works

The bottom line is you use your AI client to talk to a structured database of quotes and authors via defined tools, getting clean data back every time.

1. First, your AI client calls a specific tool. For example, you ask it to list all available tags using `list_quote_tags`.
2. The server runs the query against the Quotable database and returns a structured response listing all available tags and their counts.
3. Your agent uses this data (e.g., seeing 'technology' is popular) to decide on the next step, like running `search_quotes` for that specific theme.

## Frequently Asked Questions

**How do I find quotes about 'leadership' using search_quotes?**
You simply ask your agent to run `search_quotes` with the keyword 'leadership'. It returns all relevant quotes and metadata found in the database for that phrase.

**Do I need an API key for get_random_quote?**
No, you don't. The Quotable service is free and open, so your agent can run `get_random_quote` immediately without needing credentials.

**What if I only know the author's name, not their slug?**
You should first use `list_quote_authors`. This tool provides a list of all authors and helps you find the exact unique identifier (the slug) needed for `get_author_details`.

**Can I see which tags are available with list_quote_tags?**
Yes, running `list_quote_tags` shows every tag in the catalog and tells you exactly how many quotes belong to each theme. It's great for planning content.

**How do I verify if the Quotable API is currently working using `check_api_status`?**
Calling `check_api_status` immediately confirms the service's operational health. This lets your agent validate connectivity before running any complex searches or fetching data, preventing unnecessary failures.

**How do I get a complete list of all authors and their descriptions using `list_quote_authors`?**
The `list_quote_authors` tool returns a comprehensive catalog of every author available. You can use this to build an internal directory or verify the source material before querying specific quotes.

**Can I combine multiple topics when searching with the `search_quotes` tool?**
Yes, you pass a phrase or list of related keywords directly into `search_quotes`. This allows your agent to find quotes that bridge multiple themes simultaneously without separate searches.

**What specific metadata do I receive when calling `get_author_details`?**
The tool provides the full biography and description associated with an author slug. You get the source material needed to fully contextualize any quote data you retrieve for your content.

**Is an API Key required for Quotable API?**
No. Quotable.io is a free and open service. This server works out of the box without any static credentials required.

**Can I filter quotes by author?**
Yes. Use the `get_random_quote` tool and provide the `author` parameter (name or slug). Your agent will return matching quotes instantly.

**What biographical data is provided for authors?**
The `get_author_details` tool provides the author's full name, a brief description, and a complete biography from the database.