Standshare

CI CodeQL Socket Badge npm version License: MIT MCP SDK

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

Tool	Description
events	Search, view, create, and update fundraising events; add stands
families	Search, view (with balance), create families; add members
users	Search, view, create, and invite user accounts
venues	Search and view venue details
finances	Family balances, event revenue, transactions, settlement, credits, scholarships
workers	Event rosters, assign workers, update attendance, check availability, view history
notifications	List, send to individual users, and broadcast org-wide announcements
reports	Admin dashboard KPIs, financial summaries, family compliance status

Resources

URI	Description
standshare://guide	Domain guide covering the entity model, financial model, and migration playbook

---

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": "[email protected]",
        "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

Variable	Required	Description
STANDSHARE_API_URL	Yes	Base URL of your StandShare API instance
STANDSHARE_TENANT_SLUG	Yes	Your organization's tenant slug
STANDSHARE_API_TOKEN	One of*	API token for token-based auth
STANDSHARE_EMAIL	One of*	Admin email for credential-based auth
STANDSHARE_PASSWORD	One of*	Admin password for credential-based auth

* 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