# ViewsBase MCP server

<img src="assets/icon.png" width="64" alt="ViewsBase">

Hosted [Model Context Protocol](https://modelcontextprotocol.io) server for [ViewsBase](https://viewsbase.com), the tracking and payout dashboard for clipping and UGC campaigns. Ask Claude, ChatGPT, Cursor or any MCP client about your campaigns: views per post on TikTok, Instagram Reels and YouTube Shorts, fake-view flags, what each creator is owed, and what needs your attention.

- **Endpoint:** `https://viewsbase.com/mcp` (Streamable HTTP)
- **Auth:** OAuth 2.1 with dynamic client registration. You sign in to ViewsBase in the browser and pick which workspaces to connect. No API key to paste.
- **Plan:** AI connections come with the Growth plan and up ([pricing](https://viewsbase.com/#pricing), 14-day free trial).
- **Docs:** [viewsbase.com/docs/mcp](https://viewsbase.com/docs/mcp)

ViewsBase calculates payouts; it never holds or sends money.

## Install

**Claude Code**
```bash
claude mcp add --transport http viewsbase https://viewsbase.com/mcp
```

**Cursor** (`~/.cursor/mcp.json`) / **VS Code** (`.vscode/mcp.json`, use `"servers"` and `"type": "http"`)
```json
{ "mcpServers": { "viewsbase": { "url": "https://viewsbase.com/mcp" } } }
```

**Codex**
```bash
codex mcp add viewsbase --url https://viewsbase.com/mcp
```

**Claude.ai / Claude Desktop:** Customize → Connectors → Add custom connector → `https://viewsbase.com/mcp`.

**ChatGPT:** Plugins → + → Add custom MCP server → Server URL `https://viewsbase.com/mcp`, Authentication OAuth.

Clients without remote support can use `npx mcp-remote https://viewsbase.com/mcp`.

## Tools

Write tools change real campaign data; good clients ask before calling them.

| Tool | What it does |
|---|---|
| `list_workspaces` | List workspaces |
| `get_connection` | Read connection |
| `search_docs` | Search the docs |
| `read_doc` | Read a docs page |
| `list_docs` | List docs pages |
| `migration_checklist` | ViewsBase 2 migration checklist |
| `list_campaigns` | List campaigns |
| `get_campaign` | Read campaign |
| `list_posts` | List posts |
| `get_post` | Read post |
| `get_post_views` | Read view history |
| `list_creators` | List creators |
| `get_creator` | Read creator |
| `list_payment_requests` | List payment requests |
| `get_payment_request` | Read payment request |
| `get_payouts_summary` | Payouts summary |
| `list_payable_creators` | List payable creators |
| `list_payment_history` | List payment history |
| `list_applications` | List applications |
| `get_needs_you` | What needs you |
| `list_activity` | List activity |
| `set_post_cpm` | Change post CPM |
| `finalize_post` | Finalize post |
| `refresh_post` | Refresh post views |
| `add_creator` | Add creator |
| `set_creator_offer` | Change creator offer |
| `set_creator_link` | Change creator link in bio |
| `pause_creator` | Pause creator intake |
| `resume_creator` | Resume creator intake |

## Links

- Website: https://viewsbase.com
- Free tools: https://viewsbase.com/tools
- Docs: https://viewsbase.com/docs

This repo holds the listing metadata only (README, `server.json` for the official MCP Registry). The server itself is hosted by ViewsBase.