Wishes

Integrations

Wishes exposes the same actions you use in the app — creating and booking wishes, browsing wishlists, managing friends — to AI agents through an MCP server and to scripts through a public HTTP API. Neither works until you explicitly grant access.

MCP server
Connect Claude or any other MCP-compatible AI agent to manage wishes, wishlists and friends on your behalf.

MCP server URL

https://api.wishes.bgmlv.com/mcp

Add it as a custom connector in your AI client, sign in, and approve the access request to get started.

  1. Add the URL above as a custom connector in your MCP client.
  2. Sign in and review the permissions it is requesting.
  3. Approve the consent screen — the agent can now act on your behalf.

Access is granted explicitly on that consent screen and can be revoked at any time in the Connected apps section below.

Public API
The same actions, over plain HTTP — for scripts, curl, and your own tools.
  • Read actions answer GET only, write actions answer POST only — the wrong method gets a 405.
  • Lists come back as { data, metadata }; errors as { error, message } with a machine-readable code.
  • Rate limits: 60 requests/minute per token, 20/minute per IP without one.
curl https://api.wishes.bgmlv.com/api/public/v1/list_wishes \
  -H "Authorization: Bearer <your-token>"

Authenticate with a personal access token below, or with OAuth if your client registers itself.

API documentationOpenAPI spec