Skip to content

Developers & AI agents

Let your AI agent run the signup sheet

A REST API and a hosted MCP server, so Claude or your own code can create events and register volunteers. Included on every plan, Free too.

Authentication

Create an API key in Settings → API keys after you sign up. Send it on every request:

Authorization: Bearer ss_your_key_here

Keys are stored only as hashes and shown once. Free accounts get 2 keys at 60 requests/minute; Premium 5 at 300/minute; Pro and Nonprofit 25 at 600/minute. Registering volunteers is unlimited on every plan; creating events counts toward the monthly event-build allowance (Free: 2).

MCP server (recommended for Claude)

Connect any MCP client over HTTP at https://signupsavant.com/api/mcp with your API key. In Claude Code:

claude mcp add --transport http signupsavant https://signupsavant.com/api/mcp \
  --header "Authorization: Bearer ss_your_key_here"
Tools exposed by the SignupSavant MCP server
ToolWhat it does
list_eventsList the organization’s events
get_eventEvent details, slots, and signup counts
create_eventCreate an event from a plain-language prompt or structured fields
add_time_slotAdd a shift to an event
register_signupSign a volunteer up for a slot

Then just ask: “Set up a park cleanup this Saturday 9 to noon for 25 volunteers and give me the signup link.”

REST API

Base URL: https://signupsavant.com/api/v1

REST API endpoints
MethodPathPurpose
GET/meAccount, plan, and event-build allowance
GET/eventsList your events
POST/eventsCreate an event — structured fields or { "prompt": "…" }
GET/events/{id}Event detail and time slots
POST/events/{id}/time-slotsAdd a shift
GET/events/{id}/signupsList signups
POST/events/{id}/signupsRegister a volunteer
Create an event from a prompt
curl -X POST https://signupsavant.com/api/v1/events \
  -H "Authorization: Bearer ss_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"food drive every Friday 2-5pm through December"}'
Register a volunteer
curl -X POST https://signupsavant.com/api/v1/events/123/signups \
  -H "Authorization: Bearer ss_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Pat Volunteer","email":"pat@example.com","time_slot_id":456}'

Responses: 201 signed up or waitlisted, 409 already signed up, 422 validation error or full, 429 rate limit or event-build allowance reached.

Get an API key in two minutes

Create a free account, then open Settings → API keys.

Get started free