# Metamaps Developer Docs

Build with Metamaps on your website, in your mobile app, in your business systems, or through an AI agent. Choose an integration for your use case, then follow the guides from installation to your first operation.

## Choose an integration

| What you want to build | Integration | Get started |
|---|---|---|
| Display a map on your website | Web Embed · embed.js | [Web embedding guide](/developers/embed/) |
| Display a map in an iOS, Android, or Flutter app | Mobile SDK | [SDK guides](/developers/sdk/) |
| Sync spots, events, or current congestion values from your system | Integration API | [API guide](/developers/api/) |
| Let an AI agent read or edit your maps | MCP | [MCP guide](/developers/mcp/) |

You can combine these integrations. For example, embed a map on your facility's website, use the SDK in your membership app, and keep store information up to date through the API. With MCP, AI agents act within the maps and operations the user authorizes.

## Before you start

For Web Embed and the SDK, publish a map and have its public URL ready. If the URL is `https://metamaps.jp/d/example`, its slug is `example`. Replace every `example` in these guides with the slug of your own map.

For the API, use the per-map integration API key issued in the Metamaps admin console. For user-authorized MCP connections, sign in to Metamaps and choose the maps and permissions on the OAuth consent screen.

## Map identifiers and authentication

| Integration | Map identifier | Authentication |
|---|---|---|
| Web Embed | `slug` or a public map URL in `src` | No API key for published maps |
| Mobile SDK | `mapSlug` | No API key for published maps |
| Integration API | `{slug}` in the request URL | `X-Api-Key` header |
| User-authorized MCP | The `map` returned by `list_maps` | OAuth |

The MCP `map` identifier differs from the public map slug. Always use the value returned by `list_maps`. Keep API keys on your server; do not put them in HTML, browser JavaScript, or distributed apps.

## Guides and references

Guides explain installation and common workflows. The [API reference](/api-v2/) describes request fields, responses, and errors. You can also read the complete iOS, Android, and Flutter installation guides and the SDK query parameter reference here.

Source code, distribution files, and release information are maintained in the [public Metamaps SDK repository](https://github.com/boldright/Metamaps-SDK). If you need help choosing an integration, [contact us](/getintouch/).