# Cryptorafts MCP - ChatGPT Developer Mode

Cryptorafts exposes a production MCP server so ChatGPT can act as a conversational interface while Cryptorafts remains authoritative for auth, KYC/KYB, ownership, matching, payment entitlements, pitch execution, and campaign tracking.

## Production URL

- MCP endpoint: https://cryptorafts.com/mcp
- Alias: https://cryptorafts.com/api/mcp
- OAuth resource metadata: https://cryptorafts.com/.well-known/oauth-protected-resource/mcp
- OAuth AS metadata: https://cryptorafts.com/.well-known/oauth-authorization-server
- Consent: https://cryptorafts.com/mcp/oauth/consent

This is not a free public directory API. Private tools require Cryptorafts OAuth (or Firebase ID token). ChatGPT/OpenAI MCP OAuth sessions waive personal KYC for pitching by default; website/API paths still enforce KYC.

## Connect in ChatGPT

1. Settings → Security and login → enable Developer mode.
2. ChatGPT Plugins / Apps → + → create developer-mode app.
3. Paste: https://cryptorafts.com/mcp
4. Choose OAuth when prompted; complete Cryptorafts consent (Google sign-in).
5. New chat → + → Developer mode → select Cryptorafts.
6. Prompt: Use Cryptorafts authenticate_session then list_projects.

## Tools

authenticate_session, list_projects, check_verification, get_pitch_entitlements, create_checkout, start_pitch_campaign, authorize_pitch_campaign, execute_pitch_campaign, get_campaign_status

Flow: authenticate → list_projects → check_verification → get_pitch_entitlements → create_checkout (if need_payment) → start_pitch_campaign → authorize_pitch_campaign → execute_pitch_campaign → get_campaign_status

create_checkout prefers USDC crypto checkout (CRYPTO_PAYMENTS_ENABLED + receive wallet/RPC); Stripe is fallback. Card details are never collected in chat.

Execute consumes entitlement only when outreach is queued/sent; failures before send release the reservation.

## Campaign APIs

- GET/POST /api/pitch-entitlements
- POST /api/pitch-entitlements/reserve|consume|release
- GET/POST /api/pitch-campaigns
- GET /api/pitch-campaigns/:id
- POST /api/pitch-campaigns/:id/authorize|execute
- POST /api/billing/pitch/checkout (method=auto|crypto|stripe)
- POST /api/billing/pitch/crypto

Full write-up: docs/MCP_CHATGPT.md in the repo.