Remote MCP server

Harpy Character Catalog for AI assistants

Connect MCP-capable assistants to public Harpy character cards. The current server is read-only and returns SFW, public, non-draft character cards ranked by all-time popularity.

Endpoint

https://harpy.chat/mcp

Available today

Tool surface

The public server exposes one read-only tool today. Keep launch copy focused on popular SFW character-card discovery until search and recommendation tools ship.

List Popular SFW Character Cards

Returns public, non-draft, SFW Harpy character cards ranked by all-time popularity.

Limit
50
Default
12

Generic MCP config

Use this shape for clients that accept a streamable HTTP MCP server in the standard mcpServers format.

{
  "mcpServers": {
    "harpy-character-catalog": {
      "httpUrl": "https://harpy.chat/mcp",
      "timeout": 20000
    }
  }
}

Packages

Client setup paths

Each client gets a support status and the exact packaging path we can stand behind today.

ChatGPT users, OpenAI API users, and future App Directory discovery.

ChatGPT

Submission

Submit the public remote MCP endpoint as a data-only ChatGPT app.

  1. Use the MCP server URL in OpenAI Developer Mode for private testing.
  2. Create an app draft in the OpenAI Platform Dashboard.
  3. Submit the app with the server URL, tool list, test prompts, screenshots, privacy policy, and support URL.

Submission server URL

https://harpy.chat/mcp

OpenAI organization verification and dashboard submission must be done from a Harpy-owned OpenAI account.

Client docs

Claude Pro, Max, Team, Enterprise, Claude Desktop, and Claude API users with remote MCP connectors.

Claude

Ready

Add Harpy as a custom remote connector.

  1. Open Customize > Connectors.
  2. Choose Add custom connector.
  3. Use https://harpy.chat/mcp as the remote MCP server URL.
  4. Enable the connector in a chat and ask for Harpy character cards.

Connector definition

{
  "name": "harpy-character-catalog",
  "url": "https://harpy.chat/mcp"
}

Anthropic directory submission or organization-level connector approval must be done from a Harpy-owned Claude account.

Client docs

Gemini CLI, Android Studio Gemini agent mode, Google Antigravity, and other Google MCP clients.

Gemini

Ready

Add Harpy as a streamable HTTP MCP server.

  1. Open the MCP server settings or edit Gemini CLI settings.json.
  2. Add a server named harpy-character-catalog.
  3. Set httpUrl to https://harpy.chat/mcp.
  4. Run /mcp or the equivalent status command to confirm the tool is discovered.

Gemini settings.json

{
  "mcpServers": {
    "harpy-character-catalog": {
      "httpUrl": "https://harpy.chat/mcp",
      "timeout": 20000,
      "includeTools": [
        "list_popular_sfw_character_cards"
      ]
    }
  }
}
Client docs

Perplexity users and Perplexity API users.

Perplexity

Watchlist

No official inbound custom MCP submission path is documented for arbitrary third-party servers.

  1. Use Harpy MCP from an MCP-capable client alongside Perplexity, or through a bridge that can call remote MCP servers.
  2. Track Perplexity for an official custom MCP client or marketplace path.
  3. Do not market this as a native Perplexity connector until Perplexity documents that surface.

Bridge endpoint

https://harpy.chat/mcp

A Perplexity partnership or support answer is needed before claiming native Perplexity distribution.

Client docs

Nous Hermes Agent users who run remote HTTP MCP servers.

Hermes Agent

Ready

Add Harpy to ~/.hermes/config.yaml under mcp_servers.

  1. Enable MCP support in Hermes if it is not already installed.
  2. Add the Harpy HTTP MCP config to ~/.hermes/config.yaml.
  3. Run hermes chat and ask Hermes to browse Harpy character cards.

~/.hermes/config.yaml

mcp_servers:
  harpy_character_catalog:
    url: "https://harpy.chat/mcp"
    timeout: 20
    connect_timeout: 5
    tools:
      include: [list_popular_sfw_character_cards]
      resources: false
      prompts: false

A public Hermes catalog listing requires a PR to the Hermes optional MCP catalog and Nous review.

Client docs

Pi coding-agent users and OpenClaw/Pi-derived agent builders.

Pi

Bridge

Use a Pi MCP adapter or mcporter-style bridge.

  1. Install a Pi MCP adapter if your Pi runtime uses the package catalog.
  2. Configure the adapter to call https://harpy.chat/mcp.
  3. Expose only the list_popular_sfw_character_cards tool until Harpy ships broader search tools.

Bridge notes

Pi does not ship native MCP support in its minimal core.
Use a Pi MCP adapter or mcporter-style bridge, then point the adapter at the Harpy streamable HTTP endpoint.
Endpoint: https://harpy.chat/mcp

A native Pi package requires choosing or building the adapter package Harpy wants to support.

Client docs

OpenClaw gateway users and OpenClaw-managed agent runs.

OpenClaw

Ready

Save Harpy in the OpenClaw MCP client-side registry.

  1. Run the openclaw mcp add command.
  2. Run openclaw mcp doctor harpy-character-catalog --probe.
  3. Restart or reload the OpenClaw runtime so the saved server is projected into eligible sessions.

OpenClaw CLI

openclaw mcp add harpy-character-catalog --url https://harpy.chat/mcp --transport streamable-http --timeout 20 --connect-timeout 5 --include 'list_popular_sfw_character_cards'
openclaw mcp doctor harpy-character-catalog --probe
Client docs

Launch copy

Prompts to test

These prompts are safe to use in demos because they match the current public tool surface.

Find 10 popular SFW Harpy characters I can use for a slow-burn roleplay.
Show me public Harpy character cards with direct URLs and short reasons to try each one.
Browse the top Harpy SFW characters and group them by roleplay vibe.
Give me a starter list of Harpy character cards for a fantasy adventure chat.

Submissions

What Harpy must own

These items cannot be completed by code because they require Harpy-owned platform accounts or directory review.

  • Harpy-owned OpenAI organization verification for ChatGPT app submission.
  • Harpy-owned Claude account or organization owner access for connector submission.
  • Domain namespace verification for chat.harpy/character-catalog in the MCP Registry.
  • A square logo, screenshots, privacy-policy URL, support URL, and public test prompts.
  • A clear launch copy block that says the current server returns popular public SFW character cards.