Verified Handles — Claude Code MCP server: setup and features
Finds verified social accounts and identifiers for people or brands. Useful when an agent needs to confirm official profiles without manual browsing.
claude mcp add --transport http verified-handles https://verifiedhandles.org/mcpWhat Verified Handles does
The server links AI tools to a directory of verified profiles and identifiers. In free mode, the agent queries names and inspects revision logs without passing an API token. All traffic runs over HTTP POST. The protocol is completely stateless.
Modifying records requires an API token or an OAuth sign-in. To prevent accidental edits, changing tools execute as a dry run first. Supplying an expired or revoked token triggers a 401 error. It will not silently fall back to public reading.
What it helps with
- find verified social profiles for a company or public figure
- verify who owns a specific handle across platforms
- inspect revision history for an existing directory entry
- manage and submit directory entries under an account
Example prompts for the agent
- Find the official GitHub handle for Anthropic using Verified Handles
- Look up the social accounts linked to the openai handle
- Check the revision history for the Stripe directory entry
How to install Verified Handles
Platform CLI: remote server
claude mcp add --transport http verified-handles https://verifiedhandles.org/mcpPlatform CLI: remote server
codex mcp add verified-handles --url https://verifiedhandles.org/mcpConfig file
{
"mcpServers": {
"verified-handles": {
"url": "https://verifiedhandles.org/mcp"
}
}
}Config file
{
"servers": {
"verified-handles": {
"type": "http",
"url": "https://verifiedhandles.org/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http verified-handles https://verifiedhandles.org/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Verified Handles
How to install Verified Handles in Claude Code?
Run claude mcp add --transport http verified-handles https://verifiedhandles.org/mcp in your terminal. For account-linked operations, specify https://verifiedhandles.org/mcp/account and authenticate using /mcp.
Do I need an API key to use Verified Handles?
Basic search and read tools require no API key or account. A key is only needed to create or update directory records.
How does the server handle modifications?
Every modifying action runs as a dry run by default. The server returns the intended state change first so it cannot be committed by mistake.
