Authentication
Bearer auth
Every request to /mcp requires a bearer header. The token is generated once and only its hash is stored.
Creating a token
curl -X POST https://anymrkt.com/api/mcp/tokens \
-H "Authorization: Bearer PLACEHOLDER" \
-H "Content-Type: application/json" \
-d '{"brandIds":["brand-uuid"],"label":"x","scope":"manage","permissions":["listings","content"]}'The response includes the plaintext token exactly once.
Token fields
| Field | Type | Description |
|---|---|---|
brandIds | string[] | Brands this token can access. |
label | string | Human-readable name. |
scope | string | view, manage, or bookings. |
permissions | string[] | Fine-grained permission scopes. |
toolFilters | string[] | null | Allow-list of tool names. |
jwk | object | null | JSON Web Key for DPoP binding. |
Default permissions: listings, availability, pricing, content
Valid: listings, availability, pricing, content, scheduling, conversation, run, webhooks
DPoP binding
Pass a jwk at creation to bind the token via DPoP. A stolen bearer token is useless without the private key.
Permissions
Listings (listings)
Create and edit what you sell.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: list_listings, get_listing, create_listing, update_listing, publish_listing, delete_listing, connect_channel
confirm requiredAvailability (availability)
Change when a listing can be booked.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: update_availability
Pricing (pricing)
Change what you charge.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: update_pricing
Content and your page (content)
Write your brand page and its wording.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: update_content, builder_describe, builder_get_page, builder_validate_page, builder_apply_template, builder_patch_page, builder_publish_page, managed_brand_provision, managed_brand_invite
confirm requiredScheduling (scheduling)
Set up meeting types and manage bookings.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: scheduler_describe, scheduler_list_meeting_types, scheduler_open_slots, scheduler_list_bookings, scheduler_create_meeting_type, scheduler_update_meeting_type, scheduler_set_availability, scheduler_set_settings, scheduler_cancel_booking
confirm requiredMessages (conversation)
Read your conversations with buyers.
| Reads | Writes | Cannot |
|---|---|---|
|
|
Tools: list_conversations
Undo (run)
Undo a whole session of an agent’s changes.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: revert_run
Webhooks (webhooks)
Send a brand’s events (orders, publishes) to a URL.
| Reads | Writes | Cannot |
|---|---|---|
|
|
|
Tools: studio_create_event_destination
Never permitted (FR36)
- Change where your payouts go
- Accept legal or policy terms on your behalf
- Delete your brand
- See your password, your payout details, or any card number