standshare-mcp

An MCP (Model Context Protocol) server for the StandShare API. Gives Claude and other MCP clients composable tools for managing fundraising events, families, workers, finances, notifications, and reports within a StandShare organization.

StandShare is a family fundraising platform where organizations manage concession stand events, assign workers, track attendance, and distribute earnings to family accounts.

Tools

Related MCP server: claude-sessions-mcp

Resources

Installation

Claude Desktop

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A — API Token (recommended)

{
  "mcpServers": {
    "standshare": {
      "command": "npx",
      "args": ["-y", "@graditipro/standshare-mcp"],
      "env": {
        "STANDSHARE_API_URL": "https://api.standshare.com",
        "STANDSHARE_TENANT_SLUG": "your-org-slug",
        "STANDSHARE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Option B — Email & Password

{
  "mcpServers": {
    "standshare": {
      "command": "npx",
      "args": ["-y", "@graditipro/standshare-mcp"],
      "env": {
        "STANDSHARE_API_URL": "https://api.standshare.com",
        "STANDSHARE_TENANT_SLUG": "your-org-slug",
        "STANDSHARE_EMAIL": "admin@yourorg.com",
        "STANDSHARE_PASSWORD": "your-password"
      }
    }
  }
}

After editing, restart Claude Desktop. Verify the server loaded via the hammer icon (🔨) in the toolbar.

Other MCP Clients

Run directly:

STANDSHARE_API_URL=https://api.standshare.com \
STANDSHARE_TENANT_SLUG=your-org-slug \
STANDSHARE_API_TOKEN=your-api-token \
npx @graditipro/standshare-mcp

Environment Variables

* Either STANDSHARE_API_TOKEN or both STANDSHARE_EMAIL + STANDSHARE_PASSWORD must be set.

Authentication

Two strategies are supported:

API Token — Set STANDSHARE_API_TOKEN. The token is sent as a Bearer header on every request. Preferred for production and automated use.

Email / Password — Set STANDSHARE_EMAIL and STANDSHARE_PASSWORD. The server logs in on first use, then uses refresh tokens to maintain the session automatically.

Local Development

git clone https://github.com/GraditiPro/standshare-mcp.git
cd standshare-mcp
npm install
npm run build

To run from a local build in Claude Desktop, replace "npx", ["-y", "standshare-mcp"] with:

{
  "command": "node",
  "args": ["/absolute/path/to/standshare-mcp/build/index.js"]
}

License

MIT