API & MCP

Manage your family's points and rewards programmatically. Connect from Claude, ChatGPT, Cursor, or any HTTP client.

MCP Quick Start

Connect your AI assistant to Pointly with Model Context Protocol. Award tokens, check balances, approve requests, and more — all through natural language.

Add to your MCP config (.claude/settings.json or project settings):

{
  "mcpServers": {
    "pointly": {
      "url": "https://platform.getpointly.app/mcp",
      "headers": {
        "Authorization": "Bearer ply_live_..."
      }
    }
  }
}

Replace ply_live_... with your API key from Settings.

Available Tools

MCP tools are designed for natural conversation — tell your assistant what you want, and it picks the right tool.

get_family_overviewFamily info, all kids with balances, pending requests
award_tokensAward tokens to kids by name
list_rewards_and_goalsBrowse the shop — rewards and savings goals
review_requestsSee and resolve pending redemptions
adjust_pointsManual point corrections with a reason
get_activityFamily or per-kid activity history

All write operations preview changes before applying. 11 tools total — see the full list via your MCP client.

REST API

For direct HTTP access. All endpoints are under https://platform.getpointly.app/api/v1

MethodEndpointDescription
GET/kidsList all kids in the family
GET/rewardsList rewards and their point costs
POST/awardsAward tokens to a kid
GET/activityGet the family activity feed
POST/points-adjustmentsAdjust a kid's points
POST/redemptions/:id/resolveApprove or deny a reward request
Full API Reference →All 44 endpoints with schemas, examples, and try-it

Authentication

API Keys

Create an API key in Settings → API Keys. Pass it as a Bearer token:

curl https://platform.getpointly.app/api/v1/kids \
  -H "Authorization: Bearer ply_live_..."

API keys require the Plus plan. The key secret is shown once on creation — store it securely.

OAuth

MCP clients that support OAuth (ChatGPT, Claude.ai, Gemini) connect automatically — no API key needed. Point the client at the MCP URL and sign in when prompted.