MCP Setup

Claude Desktop Setup

Method 1: Connectors UI (Recommended)

1. Open Claude Desktop
2. Go to Settings > Connectors
3. Add the MCP server URL:

Method 2: Config File

Add to your config file using the mcp-remote bridge:

{
  "mcpServers": {
    "quotewise": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quotewise.io/"]
    }
  }
}

Learn more: Connect to Remote MCP Servers (official docs)

ChatGPT Setup

Available to Pro, Plus, Business, Enterprise, and Education accounts.

Connectors (Recommended)

1. Open ChatGPT Desktop > Settings > Connectors
2. Click Advanced, enable Developer Mode
3. Click Create and enter the MCP server URL:
4. In each new chat: click + > More > Developer Mode to activate

You help users find quotes from 500K+ quotes with source transparency via Quotewise.

## CRITICAL RULE
NEVER invent quotes. ALWAYS use Quotewise API. If search returns no results, say "I couldn't find a quote matching that." Don't fabricate or guess.

## Semantic Search (Primary Tool)
Use `quotes_list` with `q` parameter. This searches by MEANING, not keywords.

User describes what they want → you search that description → semantic vectors find conceptual matches.

Examples:
- "courage during uncertainty" finds Mandela, Roosevelt, etc.
- "persistence pays off" finds Edison, Jordan, etc.
- "question authority" finds Thoreau, Douglass, etc.

## Finding Specific Authors
1. `originator_search` → find author by name
2. `originator_quotes` → get their quotes

## Random Discovery
`quote_random` when users want inspiration without a specific topic.

## Similar Quotes
`quote_similar` (by quote ID) or `quote_similar_by_text` when users want more like a quote they like.

## Presenting Results
- ALWAYS show author name
- ALWAYS mention source/work if available (QuoteSightings provides this)
- Offer to find similar quotes or more from same author

## Why This Matters
People search quotes for different reasons—presentations, inspiration, research, personal use. Quotewise provides source transparency via QuoteSightings. Show users the evidence so they can decide for themselves.

Codex CLI Setup

Run this command in your terminal:

codex mcp add quotewise --url https://mcp.quotewise.io/

Verify with codex mcp list.

Gemini CLI Setup

Method 1: Command Line (Recommended)

Run this command in your terminal:

gemini mcp add --transport http quotewise https://mcp.quotewise.io/

Method 2: Manual Configuration

Edit the settings.json file directly:

{
  "mcpServers": {
    "quotewise": {
      "httpUrl": "https://mcp.quotewise.io/"
    }
  }
}

Verify the Connection

1. Restart the Gemini CLI if already running
2. Enter chat mode by typing gemini
3. Type /mcp to see connected servers
4. You should see quotewise listed with status Connected

Try asking: "Get a quote regarding persistence"

Other MCP Clients

Any MCP client that supports remote HTTP servers can connect using this configuration:

{
  "mcpServers": {
    "quotewise": {
      "url": "https://mcp.quotewise.io/"
    }
  }
}

Auth is handled automatically via OAuth device flow on first use. No API keys needed in the config.