Pointagram MCP server
28 operations0 webhooks
Gamification platform for scoring teams and players, running competitions and leaderboards, and running a reward store.
Try Pointagram with your agent
Connect Pointagram, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Pointagram on my account, then run one read-only example and show me the result.
Pointagram tools and triggers
Tools are what your agent can do in Pointagram through Corsair's MCP server. Triggers are the Pointagram events a routine can start from.
Reward Store
- ItemRead-only
Read one reward store item
rewardStore.item
- ItemsRead-only
List the items in a reward store
rewardStore.items
- PurchaseDestructive
Spend a player's currency on a reward store item, which creates an order to fulfil
rewardStore.purchase
- PurchasesRead-only
List the orders in a reward store, for one member or for everyone
rewardStore.purchases
- Revoke PurchaseDestructive
Revoke an order. The docs do not say whether the spent currency is returned, so treat it as final
rewardStore.revokePurchase
- SettingsRead-only
Read the reward store settings and currencies for a profile
rewardStore.settings
- Update PurchaseWrite
Move an order along its delivery status: PURCHASED, PROCESSED or DELIVERED. Needs admin rights
rewardStore.updatePurchase
Teams
- Add PlayerWrite
Add a player to a team, identified by player id, external id or email
teams.addPlayer
- CreateWrite
Create a team with a name and an icon
teams.create
- GetRead-only
Read one team by id
teams.get
- ListRead-only
List teams
teams.list
- List PlayersRead-only
List the players in a team
teams.listPlayers
- Remove PlayerDestructive
Remove a player from a team. The player keeps their points and stays in Pointagram
teams.removePlayer
- UpdateWrite
Update a team's name, icon or filter setting
teams.update
Players
- CreateDestructive
Create a player with a name and an email or external id; an online player is also invited. A player whose external id already exists is reported as a failure, not created twice
players.create
- DeleteDestructive
Soft delete a player. Pointagram keeps the record for you to anonymize in the app, and refuses to remove admin users
players.delete
- GetRead-only
Read one player by profile id
players.get
- ListRead-only
List players, optionally filtered by name, email or external id, with `next_offset` paging
players.list
- UpdateDestructive
Update a player's name, email, external id or online status; making a player online invites them
players.update
Score Series
- Add PointsDestructive
Score points for a player in a score series, optionally with a comment, tags and a transaction reference that makes a repeat call replace the earlier one
scoreSeries.addPoints
- GetRead-only
Read one score series by id
scoreSeries.get
- HistoryRead-only
Read the points history of a score series, filtered by tag, point type, team, player and time window, with `next_offset` paging. A series with no points yet answers "Score serie not found"
scoreSeries.history
- ListRead-only
List score series
scoreSeries.list
- Point TypesRead-only
List the point types a score series defines
scoreSeries.pointTypes
Competitions
- GetRead-only
Read one competition by id
competitions.get
- ListRead-only
List competitions, optionally narrowed to one player, id or access key
competitions.list
- PlayersRead-only
List the players in a competition with their score and rank
competitions.players
Test
- CredentialsRead-only
Confirm the Api-Key and Api-User pair and read the organization it belongs to; touches no tenant data
test.credentials
Connect Pointagram to Claude, ChatGPT or Cursor
- 1
Connect Pointagram in Corsair
Add your Pointagram API key once in Corsair. Corsair stores the credential encrypted and makes the Pointagram API calls for your agent, so it never goes into a prompt or a config file. Connect Pointagram
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Pointagram. On a ChatGPT personal plan, connect Pointagram here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Pointagram's read and write operations run right away and its 7 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/pointagram, add the Pointagram plugin, and connect with an API key. Then call methods like corsair.pointagram.api.competitions.get() from your app. Corsair keeps each tenant isolated.
Yes. Pointagram requires an API key from your Pointagram account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Pointagram, GitHub, Notion, Stripe, and the rest. Trigger Pointagram from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for gamification platform for scoring teams and players, running competitions and leaderboards, and running a reward store. Common builds include sync jobs, admin tooling, and agents that call Pointagram APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Pointagram API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/pointagram in the open repo. When Pointagram ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Pointagram data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Pointagram data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Pointagram on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 7 destructive Pointagram operations. You can change a link's mode at hub.corsair.dev/me.