llms.txt Content
# SIGNALS Agent Platform
> MCP-powered AI agent management for loyalty programs
## What is SIGNALS?
SIGNALS is a loyalty and rewards platform that enables brands and creators to launch managed programs with task systems, points economies, gift card rewards, referral programs, and engagement tracking. The MCP Agent Platform allows AI agents to autonomously manage these programs via the Model Context Protocol.
## Endpoint
POST /mcp
Authorization: Bearer mcp_live_XXXXX
## Quick Start
1. Generate an API key from the admin dashboard
2. Connect with any MCP-compatible client
3. Call tools/list to see available tools
4. Start managing portals programmatically
## Authentication
- API keys use SHA-256 hashing with timing-safe comparison
- Keys are scoped to an organization with specific permissions
- Rate limits: configurable per-key (default 500/hour, 5000/day)
## Permission Scopes
portal:read, portal:write, tasks:read, tasks:write, users:read, users:write,
analytics:read, content:write, rewards:read, rewards:write, nft:read, nft:write,
billing:read, billing:write, export:read, customize:write, marketing:read, marketing:write
## Human-in-the-Loop (HITL)
High-risk actions require owner approval:
- Portal creation/deletion
- User bans
- Financial transactions (plan upgrades, add-ons)
- NFT contract deployment
- Claim drop distributions
- Content publishing
Approvals expire after 24 hours. Owners are notified via email, in-app notifications, and webhooks.
## Tool Categories (63 total)
- Portal Management (6): list-portals, get-portal-config, get-portal-stats, update-portal-config, create-portal, delete-portal
- Customization (8): get-theme-presets, set-portal-theme, set-portal-colors, set-portal-branding, set-portal-background, set-custom-css, set-portal-fonts, preview-theme
- Task Management (8): list-tasks, create-task, update-task, delete-task, get-task-completions, list-task-categories, create-task-category, bulk-create-tasks
- User Management (7): list-users, get