# Harpy Character Catalog MCP

Remote MCP endpoint: https://harpy.chat/mcp

Setup page: https://harpy.chat/mcp/setup

Machine-readable client package: https://harpy.chat/mcp/clients.json

Registry server.json: https://harpy.chat/mcp/server.json

## Available tool

- list_popular_sfw_character_cards: Returns public, non-draft, SFW Harpy character cards ranked by all-time popularity. Default limit 12. Maximum limit 50. Supports offset pagination.

## Example prompts

- 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.

## ChatGPT

Status: submission

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

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

```
https://harpy.chat/mcp
```

Docs: https://developers.openai.com/apps-sdk/deploy/submission

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

## Claude

Status: ready

Add Harpy as a custom remote connector.

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

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

Docs: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

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

## Gemini

Status: ready

Add Harpy as a streamable HTTP MCP server.

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

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

Docs: https://geminicli.com/docs/tools/mcp-server/

## Perplexity

Status: watchlist

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

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

```
https://harpy.chat/mcp
```

Docs: https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server

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

## Hermes Agent

Status: ready

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

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

```
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
```

Docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp

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

## Pi

Status: bridge

Use a Pi MCP adapter or mcporter-style bridge.

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

```
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
```

Docs: https://lucumr.pocoo.org/2026/1/31/pi/

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

## OpenClaw

Status: ready

Save Harpy in the OpenClaw MCP client-side registry.

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

```
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
```

Docs: https://docs.openclaw.ai/cli/mcp

## Submission checklist

- 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.