# Firstory MCP — AI Agent Index

> Live machine-readable index for AI agents. Tools are generated from the server's
> tool registry. Full project docs: https://github.com/clchinkc/firstory-mcp

## Quick Reference

| Item | Value |
|------|-------|
| Production MCP | `https://firstory-mcp.vercel.app/mcp` |
| Repository | https://github.com/clchinkc/firstory-mcp |
| License | MIT |

## MCP Tools

| Tool | Description |
|------|-------------|
| `character-query` | Analyze a specific named character's consistency in a story passage — detects tr... |
| `character-list` | Return a lightweight roster of all registered characters (id, name, role, aliase... |
| `character-profile` | Return the complete profile for a specific character — full traits, relationship... |
| `upsert-character` | Create or update a character profile (traits, relationships, arc, notes). Use wh... |
| `trigger-analysis` | Scan a story passage for consistency issues across ALL registered characters sim... |
| `feedback-character` | Submit editorial judgment on a character analysis result — accepts or dismisses ... |
| `account-status` | Return the user's current subscription tier (free/pro) and whether billing actio... |
| `create-checkout-session` | Start a Stripe checkout flow to upgrade to the pro tier. Use when account-status... |
| `create-billing-portal-session` | Start a Stripe billing portal for subscription management — cancel, change plan,... |

## For AI Agents

- **MCP Endpoint**: https://firstory-mcp.vercel.app/mcp (Streamable HTTP)
- **Server Card**: https://firstory-mcp.vercel.app/.well-known/mcp/server-card.json
- **Auth Guide**: https://firstory-mcp.vercel.app/auth.md
- **OpenAPI Spec**: https://firstory-mcp.vercel.app/openapi.json
- **Agent Discovery**: https://firstory-mcp.vercel.app/.well-known/agent.json

## Auth

- Discovery: no bearer token required
- Tools: OAuth bearer via Supabase
- Demo token available for testing (see auth.md)

## Pricing

- **Free**: Limited character profiles
- **Pro**: $9 one-time — unlimited profiles, Stripe checkout