delphy-mcp

MCP server for Delphy — the @identity registry for the agentic web.

Search, discover, and manage entity profiles that AI agents can understand and use.

Install

npx -y delphy-mcp

Setup

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "delphy": {
      "command": "npx",
      "args": ["-y", "delphy-mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "delphy": {
      "command": "npx",
      "args": ["-y", "delphy-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "delphy": {
      "command": "npx",
      "args": ["-y", "delphy-mcp"]
    }
  }
}

Tools

| Tool | Description | |------|-------------| | search | Search the registry by keyword, category, kind, or location | | discover | Find nearby real-world entities via OpenStreetMap | | get_profile | Get a published profile summary | | get_manifest | Get the full raw delphy.json manifest | | get_skill | Get an entity's agent-readable skill.md | | onboard | Create a new @identity (validate or create) | | exchange_token | Exchange a claim_secret for a Bearer token | | edit_profile | Edit an existing profile (requires auth) | | import_discovered | Import an OSM entity as a draft profile (requires auth) |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | DELPHY_API_URL | https://delphy.network | API base URL | | DELPHY_TOKEN | (none) | Pre-configured Bearer token for write operations |

Auth Flow

Read tools (search, discover, get_profile, get_manifest, get_skill) are public — no auth needed.

For write tools (edit_profile, import_discovered):

1. Create a profile with onboard (mode: "create") — save the claim_secret
2. Use exchange_token with your slug + claim_secret to get a Bearer token
3. The token is stored in memory — write tools use it automatically

License

MIT