# Pointagram — how to use (mcp.ai)

Connect your Pointagram account and use 8 tools for productivity straight from your AI agent. Connect with your own API key. Pointagram is a gamification tool that increases motivation and team achievements. Keep your team goal-oriented and celebrate great performance together.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_pointagram?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `pointagram_add_score`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/pointagram`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/pointagram/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/pointagram/add/score` — Tool to add points to Pointagram players in a score series. Use when you need to award points with optional tags, descriptions, and automatic player creation.
  - body: { tags?: object[], points?: integer, comment?: string, player_id?: string, score_time?: string, player_name?: string, player_email?: string, create_player?: integer, pointtype_name?: string, scoreseries_id?: string, source_score_id?: string, scoreseries_name?: string, player_external_id?: string }
- `POST https://api.mcp.ai/api/pointagram/list/competition/players` — Tool to fetch competition players and standings in Pointagram. Returns detailed player rankings, scores, and competition participation data. Use when you need to retrieve player standings, competition
  - body: { player_id?: string, competition_id?: string, player_external_id?: string }
- `POST https://api.mcp.ai/api/pointagram/list/competitions` — Tool to fetch competitions in Pointagram with optional filtering. Use when you need to retrieve competition information including rankings and scores. Supports filtering by player (email, name, extern
  - body: { filter?: string, accesskey?: string, search_by?: string, competition_id?: integer|string }
- `POST https://api.mcp.ai/api/pointagram/list/players` — Tool to fetch and list players in Pointagram with optional filtering. Use when you need to retrieve player information including name, email, external ID, and status. Supports filtering by email, name
  - body: { filter?: string, search_by?: string }
- `POST https://api.mcp.ai/api/pointagram/list/score/series` — Tool to list all score series in Pointagram. Use when you need to retrieve all configured score series collections that track and measure different point types.
- `POST https://api.mcp.ai/api/pointagram/list/score/series/history` — Tool to fetch historical point data for a score series. Returns time-series data of points awarded over time with optional filtering by tags, teams, players, and time range. Use when you need to retri
  - body: { limit?: integer, time_to?: string, offset_id?: string, time_from?: string, tags_filter?: string, show_revoked?: integer, teams_filter?: string, player_filter?: string, scoreseriesid: integer, tags_or_filter?: string, offset_timestamp?: string }
- `POST https://api.mcp.ai/api/pointagram/list/score/series/point/types` — Tool to fetch point types for a specific score series in Pointagram. Use when you need to retrieve the different types of points that can be awarded within a score series.
  - body: { scoreseries: integer }
- `POST https://api.mcp.ai/api/pointagram/list/teams` — Tool to fetch and list all teams in Pointagram. Returns team information including ID, name, and icon. Use when you need to retrieve all available teams.

## Example prompts
- "What can I do in Pointagram?"
- "Show me a summary of my Pointagram account"

## More
- Page: https://mcp.ai/pointagram
- Agent spec (llms.txt): https://mcp.ai/pointagram/llms.txt
- Postman collection: https://mcp.ai/pointagram/postman.json