Is Signupgenius free?

Yes, Signupgenius is free to use.

How do I install Signupgenius?

Signupgenius is a local plugin. Install it using npm package: signupgenius-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Signupgenius need?

Signupgenius requires the following credentials or environment variables: SIGNUPGENIUS_EMAIL, SIGNUPGENIUS_PASSWORD, SIGNUPGENIUS_USER_KEY, SIGNUPGENIUS_NAME, SIGNUPGENIUS_BASE_URL, SIGNUPGENIUS_LEGACY_BASE_URL, SIGNUPGENIUS_LOGIN_URL. You can find setup instructions on the server detail page.

What AI apps work with Signupgenius?

Signupgenius uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Signupgenius MCP Server

by Chris Hall

Developer ToolsLow Risk10.0LocalNew

Free

SignUpGenius for Claude — sign-ups, slot reports, and groups. Free accounts or Pro API key.

About

SignUpGenius for Claude — sign-ups, slot reports, and groups. Free accounts or Pro API key.

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). 1 code issue detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (16/16 approved). 1 finding(s) downgraded by scanner intelligence.

7 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

SignUpGenius login email (recommended). Pair with SIGNUPGENIUS_PASSWORD for session mode — works on free accounts. No SSO/2FA.Optional

Environment variable: SIGNUPGENIUS_EMAIL

SignUpGenius password (recommended) — required iff SIGNUPGENIUS_EMAIL is set.Required

Environment variable: SIGNUPGENIUS_PASSWORD

SignUpGenius Pro API key (Pro Tools > API Management). Required only for slot REPORTS — Pro subscription needed.Required

Environment variable: SIGNUPGENIUS_USER_KEY

Friendly account name used in startup logs.Optional

Environment variable: SIGNUPGENIUS_NAME

Override the default JSON API base (v2/k for key mode, v3 for session mode).Optional

Environment variable: SIGNUPGENIUS_BASE_URL

Session mode only: override the host for legacy /SUGboxAPI.cfm calls. Defaults to https://www.signupgenius.com.Optional

Environment variable: SIGNUPGENIUS_LEGACY_BASE_URL

Session mode only: override the login-form host. Defaults to https://www.signupgenius.com.Optional

Environment variable: SIGNUPGENIUS_LOGIN_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-chrischall-signupgenius-mcp": {
      "env": {
        "SIGNUPGENIUS_NAME": "your-signupgenius-name-here",
        "SIGNUPGENIUS_EMAIL": "your-signupgenius-email-here",
        "SIGNUPGENIUS_BASE_URL": "your-signupgenius-base-url-here",
        "SIGNUPGENIUS_PASSWORD": "your-signupgenius-password-here",
        "SIGNUPGENIUS_USER_KEY": "your-signupgenius-user-key-here",
        "SIGNUPGENIUS_LOGIN_URL": "your-signupgenius-login-url-here",
        "SIGNUPGENIUS_LEGACY_BASE_URL": "your-signupgenius-legacy-base-url-here"
      },
      "args": [
        "-y",
        "signupgenius-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

signupgenius-mcp

MCP server for SignUpGenius. 13 read tools and 1 write across profile, groups, sign-ups, and reports.

Two auth modes:

Session mode (recommended). Logs in with your normal email/password to call the same web API the signupgenius.com dashboard uses. Free accounts work. No SSO/2FA.
Key mode. Uses the documented Pro API key. Required only for the slot REPORT tools (filled/available/all-participants). Pro subscription needed.

Both modes can be configured at the same time — set SIGNUPGENIUS_USER_KEY to force key mode, otherwise email/password takes effect.

Tools

Domain	Tools	Mode
Profile	`signupgenius_get_profile`	both
Groups	`signupgenius_list_groups`, `signupgenius_list_group_members`, `signupgenius_get_group_member`, `signupgenius_add_group_member` (write)	both
Sign-ups	`signupgenius_list_created_active`, `_expired`, `_all`, `signupgenius_list_invited`, `signupgenius_list_signedupfor`	both
Sign-ups (extras)	`signupgenius_legacy_get_my_signups`	session only
Reports	`signupgenius_report_all`, `signupgenius_report_filled`, `signupgenius_report_available`	key only

Notes on session-mode sign-up listings: the v3 endpoints signups/created, signups/invited, and signups/signedupfor return the full list in one paginated call (no separate active/expired URLs). The three signupgenius_list_created_* tools all map to the same endpoint in session mode; filter by enddate client-side. The bonus signupgenius_legacy_get_my_signups calls the same backend the SignUpGenius wizard itself uses and sometimes returns fuller data.

Reports in session mode fail fast with a clear ModeMismatchError telling the user to set SIGNUPGENIUS_USER_KEY.

Configuration

Session mode (recommended)

SIGNUPGENIUS_EMAIL=you@example.com
SIGNUPGENIUS_PASSWORD=your-password
SIGNUPGENIUS_NAME=Family               # optional, log label only

The server logs into signupgenius.com on first request, caches the JWT and session cookies, and silently re-logs in on a 401. Treat .env like a password file — it's gitignored here, do not commit.

Direct email/password accounts only. Won't work with Google/Apple/Facebook/Microsoft SSO or 2FA, same caveat as similar sibling MCPs.

Key mode (Pro only)

SIGNUPGENIUS_USER_KEY=your-api-key
SIGNUPGENIUS_NAME=PTA Org              # optional

Find the user key in SignUpGenius under Pro Tools → API Management.

Both at once

Set both. Key mode wins. Useful if you have Pro for some accounts and want reports while still using your normal login elsewhere.

Advanced overrides

Env var	Default	Purpose
`SIGNUPGENIUS_BASE_URL`	key: `https://api.signupgenius.com/v2/k`session: `https://api.signupgenius.com/v3`	Override the JSON API base.
`SIGNUPGENIUS_LEGACY_BASE_URL`	`https://www.signupgenius.com`	Override the host for `/SUGboxAPI.cfm?go=…` legacy calls.
`SIGNUPGENIUS_LOGIN_URL`	`https://www.signupgenius.com`	Override the login form host.

ToS caveat

SignUpGenius's terms generally prohibit scripted/automated access. Session mode is "your own account, your own risk" — fine for personal automation but not something you should run at scale or on accounts you don't own.

Local dev

npm install
npm run build
npm test

Point an MCP host at dist/bundle.js with the env vars above, or run npm run dev after creating a .env.

Tests: vitest, 100% line/branch/function coverage. End-to-end tests against the SignUpGenius API are not in CI by design — running them requires real credentials.

Notes

The Pro v2/k API authenticates via a user_key query param. The session API uses a JWT Bearer + session cookie. The client picks the right one based on which env vars you set.
All response envelopes are normalized to { data, message, success } (lowercase) regardless of which surface served the request — the legacy SUGboxAPI dispatcher's uppercase envelope is rewritten internally.
For testing the Pro v2/k surface without an account, SignUpGenius publishes a frozen demo key: V0FzMkxZcmVOZlVnclZMVEl6dGhWQT09.

Developed and maintained by AI (Claude). Use at your own discretion.