# Placekey — how to use (mcp.ai)

Connect your Placekey account and use 4 tools for analytics straight from your AI agent. Connect with your own API key. Placekey standardizes location data by assigning unique IDs to physical addresses, simplifying address matching and enabling data sharing across platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_placekey?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `placekey_get_geocode_from_address`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/placekey`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/placekey/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/placekey/get/geocode/from/address` — This tool retrieves geocode information (latitude and longitude) for a given address using the Placekey API. It accepts address components (street_address, city, region, postal_code, iso_country_code)
  - body: { city: string, region: string, postal_code: string, street_address: string, iso_country_code: string }
- `POST https://api.mcp.ai/api/placekey/get/placekey` — Tool to get a Placekey for a single location using address, coordinates, or POI details. Use when you need to obtain a unique identifier for a physical place with support for address fields, coordinat
  - body: { city?: string, region?: string, options?: object, latitude?: number, query_id?: string, longitude?: number, postal_code?: string, location_name?: string, place_metadata?: object, street_address?: string, iso_country_code?: string }
- `POST https://api.mcp.ai/api/placekey/get/placekey/from/address` — Convert a physical address into a unique Placekey identifier. The Placekey is a universal standard identifier for any physical place that helps in location matching, enrichment, and deduplication.
  - body: { city: string, region: string, postal_code: string, location_name?: string, street_address: string, iso_country_code: string }
- `POST https://api.mcp.ai/api/placekey/get/placekeys/bulk` — Get Placekeys for multiple locations in bulk (up to 100 queries per request). All queries must have the same iso_country_code. Supports address, coordinates, and POI queries with optional query_id for
  - body: { options?: object, queries: object[] }

## Example prompts
- "What can I do in Placekey?"
- "Show me a summary of my Placekey account"

## More
- Page: https://mcp.ai/placekey
- Agent spec (llms.txt): https://mcp.ai/placekey/llms.txt
- Postman collection: https://mcp.ai/placekey/postman.json