{
  "markdown": "# Quotewise MCP Server\n\nSemantic quote search for AI assistants. Find quotes by meaning, verify attributions, with source transparency via QuoteSightings.\n\n[![npm version](https://img.shields.io/npm/v/@quotewise/mcp.svg)](https://www.npmjs.com/package/@quotewise/mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@quotewise/mcp.svg)](https://www.npmjs.com/package/@quotewise/mcp)\n[![GitHub repo](https://img.shields.io/github/stars/quotewise/mcp.svg)](https://github.com/quotewise/mcp)\n\n## Quick Setup\n\nRun the setup helper to get config for your client:\n\n```bash\nnpx @quotewise/mcp setup\nnpx @quotewise/mcp setup claude-desktop\nnpx @quotewise/mcp setup gemini\n```\n\nOr follow the client-specific instructions below.\n\n## Setup by Client\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http quotewise https://mcp.quotewise.io/\n```\n\nVerify with `claude mcp list` or `/mcp` inside a session.\n\n### Claude Desktop\n\nAdd via Settings > Connectors in the app UI, or add to your config file using the `mcp-remote` bridge:\n\n```json\n{\n  \"mcpServers\": {\n    \"quotewise\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.quotewise.io/\"]\n    }\n  }\n}\n```\n\n| OS | Config Path |\n|----|-------------|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n> **Note:** Claude Desktop does not support remote HTTP servers directly in the config file. The `mcp-remote` bridge runs a local stdio process that proxies to the remote server. Requires Node.js.\n\n### ChatGPT\n\n1. Open ChatGPT Desktop > Settings > Connectors > Advanced > enable **Developer Mode**\n2. Click **Create** and enter `https://mcp.quotewise.io/` as the MCP server URL\n3. In each new chat: click **+** > **More** > **Developer Mode** to activate\n\nAvailable to Pro, Plus, Business, Enterprise, and Education accounts.\n\n### Codex CLI\n\nAdd to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.quotewise]\nurl = \"https://mcp.quotewise.io/\"\n```\n\n### Gemini CLI\n\n```bash\ngemini mcp add --transport http quotewise https://mcp.quotewise.io/\n```\n\nOr add to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"quotewise\": {\n      \"httpUrl\": \"https://mcp.quotewise.io/\"\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nMost MCP clients use the standard `mcpServers` format:\n\n```json\n{\n  \"mcpServers\": {\n    \"quotewise\": {\n      \"url\": \"https://mcp.quotewise.io/\"\n    }\n  }\n}\n```\n\n## Authentication\n\n**Anonymous access** works immediately — 20 requests/day, no signup needed.\n\n**For higher limits**, [create a free account](https://quotewise.io/signup/) and then generate an API key from your [developer dashboard](https://quotewise.io/developers/dashboard/). The MCP server uses OAuth device flow — you'll be prompted on first use.\n\nSee [quotewise.io/plans](https://quotewise.io/plans/) for current rate limits and pricing.\n\n## Tools Available\n\n18 tools for quote discovery, attribution lookup, and collection management:\n\n### Discovery\n- `quotes_about` — Semantic search by concept (\"courage during setbacks\")\n- `quotes_by` — Find quotes by a specific person\n- `quotes_from` — Find quotes from a specific source/book\n- `quotes_like` — Find similar quotes via vector similarity\n- `quotes_containing` — Exact phrase search\n- `who_said` — Attribution lookup (catches misattributions!)\n- `quote` — Get full details for a single quote (by short code)\n- `quote_random` — Discover random quotes\n\n### Exploration\n- `originators` — Search/browse authors and speakers\n- `originators_like` — Find similar authors\n- `sources` — Search/browse books, speeches, works\n- `quote_relations` — Find related quotes (similar themes, same author, etc.)\n- `search_proverbs` — Search proverb database for wise sayings\n\n### Collections (requires auth)\n- `collection` — Create, list, update, delete collections\n- `collection_quotes` — Add/remove quotes from collections\n\n### Utilities\n- `ping` — Health check (test connectivity)\n- `auth_status` — Check authentication status and rate limits\n- `flag_content` — Flag inappropriate or misattributed quotes\n- `propose_edit` — Suggest corrections to quote text or attribution\n\n## Filters\n\nAll search tools support powerful filters:\n\n| Filter | Values |\n|--------|--------|\n| `length` | brief, short, medium, long, passage |\n| `max_chars` | 280 (Twitter), 500 (Threads), etc. |\n| `structure` | prose, verse, one-liner |\n| `language` | \"en\", \"es\", \"French\", etc. |\n| `gender` | female, male, non-binary |\n| `reading_level` | elementary, middle_school, high_school, college |\n| `content_rating` | G, PG, PG-13, R |\n\n## Example Prompts\n\n- \"Find me a short quote about persistence for a tweet\"\n- \"What did Einstein actually say about imagination?\"\n- \"Quotes by women about resilience\"\n- \"Who said 'be the change you wish to see'?\"\n- \"Find quotes similar to 'the journey of a thousand miles'\"\n\n## Source Transparency\n\nEvery quote includes **QuoteSightings** — citations showing where we found it. See sources before you share.\n\n## Troubleshooting\n\n**Connection refused or timeout:** Verify you can reach `https://mcp.quotewise.io/` from your network. Corporate firewalls may block the connection.\n\n**\"Rate limit exceeded\":** Anonymous access allows 20 requests/day. Sign up at [quotewise.io](https://quotewise.io) for higher limits.\n\n**\"Invalid authentication token\":** API tokens use the `qw_` prefix. Regenerate your key at [quotewise.io/developers/dashboard](https://quotewise.io/developers/dashboard/).\n\n**Claude Desktop not connecting:** Claude Desktop requires the `mcp-remote` bridge for remote servers. See the [Claude Desktop setup](#claude-desktop) section above.\n\n**Tools not appearing:** After adding the server config, restart your MCP client. Use the `ping` tool to verify connectivity.\n\n## Links\n\n- **Docs**: [quotewise.io/developers/mcp](https://quotewise.io/developers/mcp/)\n- **API Reference**: [api.quotewise.io/docs](https://api.quotewise.io/docs/)\n- **Web**: [quotewise.io](https://quotewise.io)\n- **llms.txt**: [mcp.quotewise.io/llms.txt](https://mcp.quotewise.io/llms.txt)\n\n## Support\n\n- Email: [q@quotewise.io](mailto:q@quotewise.io)\n- Issues: [github.com/quotewise/mcp/issues](https://github.com/quotewise/mcp/issues)\n\n## License\n\nMIT © [Quotosaurus LLC](https://quotewise.io)\n",
  "bytes": 6321,
  "sha": "16d5177b7c9756c57812c4e5b11512542d0b7683bcf74e278456d0677cfa4e31",
  "repo_slug": "quotewise/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_quotewise_mcp_c9f7ffad/readme"
}