fanful_agent_surface_list
No-network MCP tool that lists current Fanful agent surfaces and follow-up issues.
Fanful agent access
MCP-first access for creator and listener agents.
Fanful exposes server-side contracts for agent clients instead of asking assistants to scrape the web UI. The current slice includes safe reads, non-mutating previews, and confirmed writes with explicit audit checks.
scripts/fanful-mcp-server.mjs/mcp
npm run mcp:servernpm run mcp:smoke:httpnpm run mcp:smokeAgent setup
One central starting point for any AI coding agent.
Setup prompt
Copy-paste prompt for Codex, Claude, ChatGPT, Cursor, and other agents.
API reference
API map, webhook recipes, SDK release plan, and code samples.
Agent skills
Copyable Fanful skills and prompts for common agent jobs.
Developer docs
Task-first docs for human developers and AI agents.
llms.txt
Canonical crawl/discovery file for model clients.
Markdown guide
Agent-facing docs for the first MCP slice and safe-use boundaries.
SDK starter
Provider-neutral TypeScript helper and no-SDK HTTP fallback for external agents.
Hosted runtime boundary
External-first runtime decision, safe run-record shape, approval, retry, and cancellation limits.
Q&A smoke matrix
Expected answers, public source citations, and overclaim checks for agent/search QA.
Community manifest
Public channel/message contract and operation descriptors.
Embedded-room manifest
Room, roster, media-token, confirmed roster writes, and moderation boundaries.
Live readiness
Fan joinability, blockers, and next actions for live rooms and Listen Along.
Creator commerce
Lesson/coaching offers, shop products, price previews, confirmed lesson/tier/shop writes, and Stripe Price mapping writes.
Artist analytics
Source funnels, content outcomes, cohorts, and recent signals with raw listener rows redacted.
Media upload sessions
Confirmed metadata, provenance, idempotency, and audit handoffs without model-visible media bytes.
Listener experience
Fan account, library, playback, preference, display-name write, and Listen Along boundaries.
Idea board
Member ideas, vote state, admin review fields, and confirmed listener submit/vote writes.
ChatGPT app readiness
Apps SDK requirements, MCP mapping, blockers, and first workflow candidates.
Action contracts
Auth, confirmation, audit, idempotency, rate-limit, and redaction rules for writes.
Workflow triggers
Signed webhook trigger catalog, subscription registry, retry keys, and redaction rules.
Agent sessions
External agent run/session contract, event replay, approvals, and cancellation.
Sync jobs
Cursor, checkpoint, duplicate-resume, and drift-report contracts for imported catalog data.
Safety boundary
Readable today, careful before writes.
The current MCP server proves discovery and read access, plus confirmed live, lesson, membership tier, shop product, and Stripe Price write paths. Unsupported billing, purchases, moderation, and creator speech remain split until each confirmation and audit contract is explicit.
Available now
Read public community-chat, embedded-room, live, creator-commerce, media-upload, listener/fan, idea-board, ChatGPT, action-contract, trigger, session, and sync-job manifests through MCP resources, HTTP manifests, and the public /mcp endpoint. Private artist analytics reads are available to creator/admin principals.
Admin reads
Environment-gated for local MCP clients; no admin token is accepted as prompt-visible tool input.
Fan reads
Listener state is sanitized from the mobile bootstrap, and live readiness reports joinability for live rooms, webinar rooms, and Listen Along without raw ids or media URLs.
Preview tools
Creator service price/policy impact, live schedule changes, live status changes, and live-room support donation copy can be previewed before confirmed writes.
ChatGPT app
A readiness manifest maps Fanful MCP tools to Apps SDK requirements; read-only tools include descriptor metadata, and confirmed listener display-name writes are listed as auth-needed until ChatGPT auth and widget needs land.
Event triggers
The workflow-trigger manifest defines signed webhook envelopes, sample payloads, an authenticated subscription registry, manual signed test delivery, and member.idea.submitted runtime fan-out for event-driven agents. Live-readiness changes, support checkouts, community moderation changes, and catalog drift still expose signed, redacted trigger status without automatic fan-out.
Run history
The agent-session manifest defines redacted multi-step run events, pending approvals, completed tool calls, cancellation semantics, and sample event-log readback before durable storage ships.
Hosted runtime
Fanful is external-first for now: no arbitrary code or general worker runtime is enabled. Future hosted workers need redacted run records, limits, approvals, cancellation, retries, and audit links before implementation.
Sync checkpoints
The sync-job manifest defines redacted source/target cursors, checkpoints, stats, duplicate-safe resumes, and drift-report boundaries before hosted sync execution ships.
Writes
Confirmed live status, embedded-room roster/stage, member idea submit/vote, lesson price, existing lesson Stripe Price mapping, membership tier lifecycle, shop product create/visibility/details/Stripe Price writes, community channel tier-access metadata, and media upload-session creation now use shared-envelope confirmation, idempotency, stale-state or session guards, and audit correlation. Other public, destructive, unsupported billing, and creator-speech actions still start from /api/agent/action-contracts.
Next slices
ChatGPT widgets, private scoped-grant client flows, and confirmed write tools are tracked as separate issues.
Current MCP surface
The first server exposes these resources and tools. Broader creator and fan workflows are tracked in GitHub issues so each increment can ship, test, merge, and clean up independently.
fanful_agent_manifest_read
Read-only MCP tool that fetches community-chat, embedded-room, live-controls, creator-commerce, artist-analytics, media-upload-session, listener-experience, idea-board, ChatGPT-app, action-contract, workflow-trigger, agent-session, or sync-job manifests.
fanful_creator_analytics_read
Read-only MCP tool for aggregate creator analytics with raw listener rows and identifiers redacted.
fanful_agent_action_contracts_read
Read-only MCP tool for the #608 action-contract manifest, with optional audience and domain filters.
fanful_live_readiness_read
Read-only MCP tool for fan live-room, embedded-room/webinar, and Listen Along readiness.
fanful_live_schedule_preview
Non-mutating MCP tool that previews live create/edit/reschedule payloads with stream fields redacted.
fanful_creator_live_schedule_create
Confirmed MCP write tool for new live-event creation with shared-envelope confirmation, idempotency, blocker checks, and audit correlation.
fanful_creator_live_schedule_update
Confirmed MCP write tool for existing live schedule changes with shared-envelope confirmation, idempotency, stale-state, and audit checks.
fanful_creator_embedded_room_roster_update
Confirmed MCP write tool for one embedded-room invite, co-host promotion, stage move, removal, or restore with shared-envelope confirmation, idempotency, stale-state, and audit checks.
fanful_live_status_preview
Non-mutating MCP tool that previews go-live/end/cancel impact with admin credentials kept in process env.
fanful_creator_live_status_update
Confirmed MCP write tool for live go-live/end/cancel/restore transitions with shared-envelope confirmation, idempotency, stale-state, and audit checks.
fanful_creator_service_price_policy_update
Confirmed MCP write tool for lesson/coaching price changes with shared-envelope confirmation, idempotency, stale-state, and creator-commerce audit checks.
fanful_creator_lesson_availability_update
Confirmed MCP write tool for future open/cancelled lesson availability windows with shared-envelope confirmation, idempotency, stale-state, and audit checks.
fanful_creator_lesson_stripe_price_select
Confirmed MCP write tool for selecting or clearing one already-known lesson Stripe Price mapping with stale-state, catalog, idempotency, and audit checks.
fanful_creator_lesson_stripe_price_create
Confirmed MCP write tool for creating and selecting one replacement lesson Stripe Price with server-side Stripe credentials, stale-state, idempotency, and audit checks.
fanful_creator_membership_stripe_price_select
Confirmed MCP write tool for selecting or clearing one already-known membership tier Stripe Price mapping with stale-state, catalog, idempotency, and audit checks.
fanful_creator_membership_stripe_price_create
Confirmed MCP write tool for creating and selecting one replacement monthly membership Stripe Price with server-side Stripe credentials, stale-state, idempotency, and audit checks.
fanful_creator_membership_tier_create
Confirmed MCP write tool for creating one inactive membership tier draft with profile, benefit, monthly amount, idempotency, and audit checks.
fanful_creator_membership_tier_update
Confirmed MCP write tool for updating one membership tier profile or benefit copy with stale-state, idempotency, and audit checks.
fanful_creator_membership_tier_archive_state
Confirmed MCP write tool for archiving or restoring one membership tier for future joins while preserving existing entitlement history.
fanful_creator_shop_product_create
Confirmed MCP write tool for creating one safe shop product with observed-product-id stale guard, duplicate id/slug checks, idempotency, and audit checks.
fanful_creator_shop_product_visibility_update
Confirmed MCP write tool for toggling active/show-in-shop flags on one existing shop product with stale-state, idempotency, and audit checks.
fanful_creator_shop_product_details_update
Confirmed MCP write tool for safe existing shop product copy, inventory, fulfillment note, download display metadata, and sort-order edits.
fanful_creator_shop_product_stripe_price_select
Confirmed MCP write tool for selecting or clearing one compatible app-state Stripe Price mapping on an existing shop product.
fanful_creator_shop_product_stripe_price_create
Confirmed MCP write tool for creating and selecting one replacement one-time shop product Stripe Price with server-side Stripe credentials, Product context, stale-state, idempotency, and audit checks.
fanful_listener_live_support_preview
Read-only MCP tool for live-room support CTA readiness and generic support/donation purchase preview copy.
fanful_listener_checkout_confirmation_render
Read-only Apps SDK render tool for support, membership, or signed-CD shop checkout confirmation summaries before the separate scoped write tool.
fanful_listener_support_checkout_start
Confirmed MCP write tool for support-only checkout starts with exact listener confirmation, idempotency, audit correlation, and redacted return fields.
fanful_listener_membership_checkout_start
Confirmed MCP write tool for membership checkout starts with exact listener confirmation, idempotency, audit correlation, server-owned Stripe Price mapping, and redacted return fields.
fanful_listener_shop_checkout_start
Confirmed MCP write tool for signed-CD shop checkout starts with exact listener confirmation, idempotency, audit correlation, active shop product checks, and redacted return fields.
fanful_listener_purchase_link_status
Read-only MCP tool for redacted support, membership, or shop checkout intent status after an agent-started checkout.
fanful_sync_job_status_read
Read-only MCP tool for the latest or addressed durable Stripe catalog app-reference sync run, checkpoint, and redacted drift output.
fanful_sync_job_run
First-party MCP run tool that persists a redacted Stripe catalog app-reference drift/checkpoint record without accepting provider credentials.
fanful_member_idea_board_read
Read-only MCP tool for visible member ideas, signed-in vote state, and admin-redacted review fields.
fanful_member_idea_submit
Confirmed MCP write tool for one visible member idea with scoped listener auth, exact public-content confirmation, idempotency, and audit correlation.
fanful_member_idea_vote_toggle
Confirmed MCP write tool for toggling or setting a listener vote on one visible idea with exact confirmation, idempotency, and audit correlation.
fanful_creator_lesson_price_preview
Non-mutating MCP tool that previews lesson/coaching price and policy impact with admin credentials kept in process env.
fanful_creator_entitlement_metadata_update
Confirmed MCP write tool for one non-default community channel tier-access metadata update with shared-envelope confirmation, idempotency, stale-state, and audit checks.
fanful://agent/surfaces
Resource form of the MCP surface catalog.
fanful://agent/community-chat/manifest
Resource for the guest/listener-safe community-chat manifest.
fanful://agent/embedded-rooms/manifest
Resource for the guest/listener-safe embedded-room manifest.
fanful://agent/live-readiness/manifest
Resource for listener-safe live joinability, media readiness, blockers, and next actions.
fanful://agent/creator-commerce/manifest
Resource for public commerce reads, admin-redacted creator commerce state, service price/policy readiness, confirmed lesson price writes, Stripe Price mapping descriptors, replacement Stripe Price creation, tier lifecycle writes, shop product create/visibility/details/Stripe Price writes, and community channel tier-access metadata writes.
fanful://agent/artist-analytics/manifest
Resource for aggregate creator analytics with raw listener rows, identifiers, and referrer query strings redacted.
fanful://agent/media-upload-sessions/manifest
Resource for confirmed creator media upload sessions, provenance descriptors, idempotency, and audit attribution without model-visible media bytes.
fanful://agent/listener-experience/manifest
Resource for public listener/fan state plus signed-in account summaries with identifiers and media URLs redacted.
fanful://agent/idea-board/manifest
Resource for member ideas, vote counts, viewer state, and creator review contracts.
fanful://agent/chatgpt-app/manifest
Resource for ChatGPT app readiness, Apps SDK requirements, MCP workflow mapping, and submission blockers.
fanful://agent/action-contracts/manifest
Resource for cross-surface action contracts covering auth, confirmation, audit, idempotency, and redaction boundaries.
fanful://agent/workflow-triggers/manifest
Resource for signed webhook trigger contracts, redacted subscription records, retry/idempotency headers, and event-driven agent boundaries.
fanful://agent/sessions/manifest
Resource for external agent run/session contracts, redacted event replay, pending approvals, and cancellation boundaries.
fanful://agent/sync-jobs/manifest
Resource for cursor-based sync jobs, redacted checkpoints, duplicate-safe resumes, and catalog drift-report boundaries.
Public and preview MCP endpoints
https://fanful.net/mcpFANFUL_BASE_URL=http://127.0.0.1:8787 npm run mcp:serverFANFUL_MCP_HTTP_URL=http://127.0.0.1:8787/mcp npm run mcp:smoke:http