Developers

Build on Mingoal.

A REST API, an MCP server, and a CLI — all backed by your club’s data. Generate an API key and automate events, members, posts, and more. Available on the Scale plan.

Quickstart Authentication Endpoints MCP server CLI

Quickstart

In your club’s Settings → Developers, generate an API key. The secret is shown once — copy it.
Send it as a bearer token on every request.
Call the API, or wire up the MCP server / CLI below.

curl https://mingoal.com/api/v1/me \
  -H "Authorization: Bearer mg_live_xxx"

Authentication & format

Authenticate with Authorization: Bearer <key> (or the X-Api-Key header). Each key is scoped to one club, with read or read+write access.

Base URL: https://mingoal.com/api/v1
Lists return { items, total, limit, offset }; single items { item }.
Errors return { error: { code, message } }.
Pagination: ?limit= (1–100) and ?offset=.
Rate limit: 600 requests/hour per key (HTTP 429 when exceeded).

Endpoints

GET	/me	Identify the key: club + scopes
GET	/club	Club details
PATCH	/club	Update club fields
GET	/members	List members
GET	/members/:id	Get a member
PATCH	/members/:id	Update role / status
GET	/events	List events (?upcoming=true)
POST	/events	Create an event
GET	/events/:id	Get an event
PATCH	/events/:id	Update an event
DELETE	/events/:id	Delete an event
GET	/events/:id/rsvps	List RSVPs
POST	/events/:id/rsvps	Create an RSVP
GET	/announcements	List announcements
POST	/announcements	Post an announcement
GET	/blog	List blog posts
POST	/blog	Create a blog post
GET	/deals	List deals
POST	/deals	Create a deal
GET	/products	List merch products
GET	/feed	List community feed posts
GET	/gallery	List albums / photos

# Create an event
curl -X POST https://mingoal.com/api/v1/events \
  -H "Authorization: Bearer mg_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"title":"Saturday Long Run","starts_at":"2026-07-04T08:00:00Z"}'

MCP server

The @mingoal/mcp-server package exposes the API as Model Context Protocol tools, so Claude Desktop (and any MCP client) can manage your club in natural language — list events, post announcements, create blog posts, and more.

Add it to your MCP client config with your API key:

{
  "mcpServers": {
    "mingoal": {
      "command": "mingoal-mcp",
      "env": { "MINGOAL_API_KEY": "mg_live_xxx" }
    }
  }
}

CLI

The @mingoal/cli package gives you a mingoal command to script your club from the terminal.

mingoal login mg_live_xxx
mingoal events list --upcoming
mingoal announcements create --title "Welcome" --body "We're live!"