Authentication
Authentication
Every request to the Maptoolkit API requires an API key. Your key identifies your account and controls which apps and domains can make requests.
You can use the Maptoolkit MCP Server on Localhost as well as all APIs without API key. You can start right away.
Get an API Key
Sign in to your Maptoolkit account to find your API key in the account settings.
Add the API Key to a Request
You can pass the API key in two ways:
As a query parameter:
?api_key=YOUR_API_KEYExample:
https://staticmap.maptoolkit.net?center=48.2,16.4&zoom=12&size=750x400&api_key=YOUR_API_KEYAs an HTTP header:
MTK-ApiKey: YOUR_API_KEYUse the header approach when you do not want the key to appear in URLs — for example, in server-side requests.
Restrict Your API Key
In the Maptoolkit admin panel, you can restrict each API key to:
- Referers — domain names that requests are allowed to come from (for browser apps)
- User-Agents — app identifiers (for mobile or server apps)
This prevents your key from being used by unauthorized applications.