# Verified Handles

> Public entries (people, organisations, things) with their official social media accounts and other identifiers, gathered from public sources and Wikidata. Most entries carry no badge; "Verified" marks one the Verified Handles team has checked. Every public entry is open data: read it as JSON with no account, or connect an AI agent over MCP.

## About

- [About Verified Handles](https://verifiedhandles.org/about): what the directory is, who runs it, and where its data comes from.
- [How Verified Handles works](https://verifiedhandles.org/methodology): the sources of its handles, how they are checked, and what Verified and Claimed mean.
- [How to check whether a social media account is official](https://verifiedhandles.org/guides/check-official-account): the checks to make, the signs of an impersonator, and how to report one on each platform.

## Docs

- [Developer docs](https://verifiedhandles.org/developers): the read API — an entry, its handles and history, search — with guides and every error.
- [Connecting an agent (MCP)](https://verifiedhandles.org/developers/mcp): the MCP server at https://verifiedhandles.org/mcp, with no key or an API key (or at https://verifiedhandles.org/mcp/account, signing in with OAuth), how to set up each client, and every tool.
- [OpenAPI 3.1 document](https://verifiedhandles.org/api/v1/openapi.json): the read API, machine-readable, with the MCP tools under x-mcp-tools.
- [Agent discovery (ARD)](https://verifiedhandles.org/.well-known/ard.json): the MCP server and the read API, listed for agent finders, with the MCP server card at https://verifiedhandles.org/mcp/server-card.

## Entries

- An entry is at https://verifiedhandles.org/<vhid> (11 digits) or https://verifiedhandles.org/<short>; its data at https://verifiedhandles.org/api/v1/entities/<vhid or short>.
- Up to 50 entries at once: https://verifiedhandles.org/api/v1/entities?ids=<key>,<key>,… (each key answered as the single read answers it).