# Verified Handles

> Verified Handles is a free MCP server for knowledge and memory. Look up official social media handles and identifiers for people, organisations and things. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://verifiedhandles.org/developers/mcp
- **Repository:** https://github.com/jameshaworthcs/verifiedhandles-mcp
- **MCP Registry name:** org.verifiedhandles/verified-handles
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Verified Handles is a public register of people, organisations and things with their official social accounts and identifiers. Its MCP server reads that register without any key, and with an API key or an OAuth sign-in it can also propose changes and report entries as the account holder.

Access is tiered. With no key, an agent sees only public reads: get_entry, search_entries, find_by_handle, get_entry_history and get_entries. A read-only key lists no write tools, and a full key lists whatever the account's role allows. Keys can carry an expiry of 1 to 90 days and a role ceiling, up to five at once. Tools that change data only show a dry run until told otherwise.

The server is stateless, answers are never cached, and the README links a Claude Desktop extension and setup guides.

## Features

- **Keyless public reads:** Look up and search entries without an API key.
- **Handle reverse lookup:** Find the entry that owns a given social handle.
- **Entry history:** Read the change history of any public entry.
- **Dry runs for changes:** Write tools only preview what they would do until told otherwise.
- **Scoped keys:** Keys can be read-only, role-capped and expire in 1 to 90 days.
- **OAuth connection:** Claude, Cursor, VS Code and others can connect via the account endpoint without a key.

## Good for

- Check whether a social account is the official one
- Find all official accounts of an organisation
- Verify a handle before an agent contacts someone
- Review who changed an entry and when
- Propose a correction to an entry through an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http verified-handles https://verifiedhandles.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://verifiedhandles.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "verified-handles": {
      "url": "https://verifiedhandles.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "verified-handles": {
      "type": "http",
      "url": "https://verifiedhandles.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "verified-handles": {
      "serverUrl": "https://verifiedhandles.org/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "verified-handles": {
      "type": "http",
      "url": "https://verifiedhandles.org/mcp"
    }
  }
}
```

## Tools

- `get_entry`: Fetch one public entry.
- `search_entries`: Search public entries.
- `find_by_handle`: Find an entry from a social handle.
- `get_entry_history`: Read an entry's change history.
- `get_entries`: Fetch several entries.

## FAQ

### Do I need a key to read?

No. The public read tools need no Authorization header.

### How do I get a key?

Any account can make one under Console, Account, Manage API keys; it is shown once.

### Can an agent change data by accident?

Tools that change something only show what they would do until told otherwise.

### How many keys can I have?

Up to 5 keys, and up to 10 connected OAuth apps.

### Is Verified Handles free?

Yes. Verified Handles is free to use.

### How do I add Verified Handles to Claude Code?

Run this command in your terminal: claude mcp add --transport http verified-handles https://verifiedhandles.org/mcp

### What are the best alternatives to Verified Handles?

The closest alternatives to Verified Handles are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/verified-handles
