# Beeminder — how to use (mcp.ai)

Connect your Beeminder account and use 5 tools for task management straight from your AI agent. Connect with your own API key. Beeminder is an online goal-tracking service that uses financial incentives-pledge money on your objectives and forfeit it if you don’t keep up-to help you achieve your goals.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_beeminder?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `beeminder_authenticate_and_redirect_user`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/beeminder`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/beeminder/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/beeminder/authenticate/and/redirect/user` — Tool to authenticate a user and redirect them to a given URL. Use when sending a user into the Beeminder web UI directly after OAuth or token validation.
  - body: { username?: string, redirect_to_url: string }
- `POST https://api.mcp.ai/api/beeminder/create/charge` — Tool to create a new charge for a user. Use when billing a user outside of goal pledges; supports dryrun mode.
  - body: { note?: string, amount: number, dryrun?: boolean, user_id: string }
- `POST https://api.mcp.ai/api/beeminder/get/all/goals` — Tool to retrieve all goals for a specified user. Use when listing a user's active goals.
  - body: { username: string }
- `POST https://api.mcp.ai/api/beeminder/get/archived/goals` — Tool to retrieve archived goals for a specified user. Use when you need to inspect a user's past archived goals.
  - body: { username: string }
- `POST https://api.mcp.ai/api/beeminder/get/user/information` — Tool to retrieve information about a specified Beeminder user. Use when you need to fetch details like timezone, goals, urgency, or deleted goals after authenticating successfully.
  - body: { skinny?: boolean, username: string, diff_since?: integer, associations?: boolean, datapoints_count?: integer }

## Example prompts
- "What can I do in Beeminder?"
- "Show me a summary of my Beeminder account"

## More
- Page: https://mcp.ai/beeminder
- Agent spec (llms.txt): https://mcp.ai/beeminder/llms.txt
- Postman collection: https://mcp.ai/beeminder/postman.json