Metadata-Version: 2.4
Name: creator-api-mcp
Version: 0.2.0
Summary: MCP server for CreatorAPI · native OnlyFans and Fansly access for AI agents
Project-URL: Homepage, https://creator-api.com
Project-URL: Documentation, https://creator-api.com/docs/quickstart
Author: AWE Trade Group LLC
License: MIT
License-File: LICENSE
Keywords: agents,ai,creator-api,fansly,mcp,onlyfans
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2
Description-Content-Type: text/markdown

# OnlyFans and Fansly MCP server · CreatorAPI

<!-- mcp-name: io.github.Creator-API/creator-api-mcp -->

**A native OnlyFans API and Fansly API, exposed as Model Context Protocol tools.** Run your
creator business from Claude, ChatGPT, Cursor or any MCP client. This server wraps
[CreatorAPI](https://creator-api.com), one REST API for native OnlyFans and Fansly access, so
an agent can read fans, messages, media, earnings, posts, transactions and subscribers across
every creator you connect.

Not scraping: CreatorAPI calls the same authenticated endpoints the apps use, through your own
session, so responses are clean and predictable JSON.

> Looking for the hosted, no install version? Add `https://api.creator-api.com/mcp` as a
> connector in Claude or ChatGPT and sign in with your account. Details at
> [creator-api.com/onlyfans-api-mcp](https://creator-api.com/onlyfans-api-mcp).

## Why

- **One key, two platforms.** Native OnlyFans and Fansly under a single `ca_live_` key, with
  Fanvue, ManyVids and JustForFans on the roadmap.
- **Built for agents.** Stable JSON, an `llms.txt` and a full machine readable reference.
- **Safe by default.** Passwordless connect, one residential IP per account, and outbound
  writes off unless you opt in.

## Get a key

Sign up at [creator-api.com/signup](https://creator-api.com/signup). You start with 1,000 free
credits, no card.

## Install

The server runs from `uvx` (or `pipx`), so there is nothing to clone.

### Claude Desktop

Add this to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "creator-api": {
      "command": "uvx",
      "args": ["creator-api-mcp"],
      "env": { "CREATOR_API_KEY": "ca_live_your_key" }
    }
  }
}
```

### Cursor, Windsurf, Cline, Claude Code

Add the same block to the client's MCP config (`mcp.json` or settings).

### Hosted, with sign in (Claude and ChatGPT)

No install. In Claude or ChatGPT, open Settings, then Connectors, then Add custom connector,
paste `https://api.creator-api.com/mcp`, and sign in with your CreatorAPI account. OAuth 2.1
with PKCE and dynamic client registration. Verified end to end with both clients.

## Tools

Reads and first party CRM writes are always available:

- `whoami`, `get_billing` · plan, scope and remaining credits
- `list_platforms`, `list_accounts` · supported platforms and your connected creators
- `native_get` · read fans, messages, media, earnings, posts, transactions and subscribers
- `get_fan_summary` · Fan AI Summary for one fan
- `list_tags`, `add_tag` · first party CRM tags
- `list_smart_links`, `create_smart_link`, `get_link_stats` · trackable links
- `list_webhook_events`, `list_webhooks`, `create_webhook` · signed event delivery
- `list_export_datasets`, `create_export`, `list_exports`, `get_export` · bulk data exports

## Outbound writes (opt in)

Sending messages and other native writes are off by default, so an agent cannot act outward
without your say so. To enable `native_write`, set `CREATOR_API_ENABLE_WRITES=1` in `env`.

## Environment

| Variable | Purpose |
| --- | --- |
| `CREATOR_API_KEY` | your `ca_live_` key (required) |
| `CREATOR_API_BASE` | override the base URL (default `https://api.creator-api.com`) |
| `CREATOR_API_ENABLE_WRITES` | set to `1` to register `native_write` |
| `CREATOR_API_MCP_TRANSPORT` | `stdio` (default), `sse`, or `streamable-http` |

## Docs

- Quickstart and full reference: [creator-api.com/docs/quickstart](https://creator-api.com/docs/quickstart)
- OnlyFans API landing: [creator-api.com/onlyfans-api](https://creator-api.com/onlyfans-api)
- Fansly API landing: [creator-api.com/fansly-api](https://creator-api.com/fansly-api)
- Machine readable: [creator-api.com/llms.txt](https://creator-api.com/llms.txt)

## License

MIT. See [LICENSE](LICENSE).

Operated by AWE Trade Group LLC, Wyoming, United States. Not affiliated with, endorsed by, or
sponsored by OnlyFans, Fansly, Fanvue or any other platform. All platform names and marks
belong to their respective owners.
