Bikepackia API keys
Last verified
A Bikepackia API key lets a program or AI agent act on a Bikepackia account through the MCP server. Keys start with bpk_, are sent as a standard bearer token, are shown only once when created, and spend credits from the account that owns them. Each account has at most one active key.
Using a key
Send the key as a bearer token in the Authorization header of every request to the MCP server:
Discovery calls (initialize and tools/list) work without a key, so a client can see what the server offers before you connect it. Every tool call needs a valid key. A missing or invalid key gets a 401 response with an explanation.
Keeping a key safe
- The full key is shown once, at creation. Bikepackia stores only a hash, so a lost key can't be recovered, only replaced.
- An account has at most one active key. Issuing a new key immediately revokes the previous one, which is also how you rotate a key.
- A key can do anything the account can do through the MCP server, including spending its credits. Treat it like a password.
Billing
A key has no separate balance. It draws from the owning account's credits, the same balance the Bikepackia apps use for Mec. Routes planned with a key are saved to that account.
Limits
These limits apply only to traffic authenticated with an API key, never to riders using the Bikepackia apps. They are per key, and the values below are the current defaults, which may change.
| Limit | Default | When you hit it |
|---|---|---|
| Requests per minute | 30 | 429 with error rate_limited and a Retry-After header |
| Requests in flight at once | 3 | 429 with error rate_limited and a short Retry-After |
| Length of a brief or instruction | 4,000 characters | Rejected by the tool's input validation before any planning runs |
| Spend per day | €20 of credits | 429 with error daily_cost_ceiling_exceeded until the next day starts (00:00 UTC) |
The daily spend limit applies on top of the account balance. It stops a leaked or runaway key from draining a well-funded account in a single day.
Frequently asked questions
How do I get a Bikepackia API key?
API access is currently available on request. Contact the Bikepackia sales team and they will set up access for your account.
Can I have more than one API key?
No. Each account has at most one active key. Creating a new key revokes the old one.
What does an API key cost?
The key itself is free. Calls that plan or refine a route spend credits from the account that owns the key.