MCP Server

Connect your AI tools.

Creedn is MCP-native. Connect any MCP-compatible AI tool — Claude, ChatGPT, Gemini — to your creator business in under 2 minutes. 24 tools. Real data. No hallucinations.

Quick Start

Generate an API Key

Go to Settings → API Keys and click "New key". Choose the permission scopes your agent needs (e.g. deals:read, invoices:read).

Copy the key immediately — it's only shown once.

Configure your MCP client

Add the following to your MCP client's configuration file:

{
  "mcpServers": {
    "creedn": {
      "url": "https://creedn.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-creedn-YOUR_KEY_HERE"
      }
    }
  }
}

Start using your tools

Your AI now has access to your real Creedn data. Try asking it to "list my brand deals", "handle my inbox", or "show my revenue summary". All responses come from your actual data — no fabricated content.

Authentication

Every request to POST /api/mcp requires a Bearer token in the Authorization header:

Authorization: Bearer sk-creedn-abc123...

API keys are hashed with SHA-256 before storage — Creedn never stores your raw key. Each key has granular permission scopes that control which tools the agent can call.

Scope-Based Access

Each tool requires a specific scope (e.g. deals:read). Write scopes automatically grant read access for the same resource.

Rate Limits

MCP requests are limited to 30 requests per minute per user. Standard X-RateLimit-* and Retry-After headers are returned.

Free vs Pro Access

Free

Read-only access to all data. Your AI tool can query deals, analytics, revenue, inbox, and news but cannot create or modify records.

✓ Read deals, analytics, revenue
✓ Read partnership inbox with AI summaries
✓ Scan Gmail for opportunities
✓ View content calendar and news
✗ Create or update deals
✗ Generate invoices
✗ Schedule content

Pro

Full read + write access. Your AI tool can autonomously manage your deal pipeline, negotiate with brands, generate and send invoices, and handle your inbox.

✓ Everything in Free
✓ Create and update deals
✓ Generate, send, and mark invoices paid
✓ Reply to brands and counter-negotiate
✓ Send emails via Gmail
✓ Schedule content to calendar
✓ Update agent memory

View pricing →

Tool Reference

24 tools

Deals

list_deals

List brand deals with optional status and limit filters.

deals:readFree

get_deal

Get full details of a single brand deal by UUID.

deals:readFree

create_deal

Create a new brand deal from detected opportunities.

deals:writePro

update_deal

Move deals through the pipeline or update values.

deals:writePro

Revenue

get_revenue_summary

Financial summary: total earned, pending, MoM growth.

revenue:readFree

Invoicing

list_invoices

List invoices with payment status and totals.

invoices:readFree

create_invoice

Generate a new invoice for a completed deal.

invoices:writePro

update_invoice

Update invoice status (draft→sent→paid). Marking paid auto-logs revenue. Optionally emails the invoice to the client.

invoices:writePro

send_invoice

Create an invoice and immediately email it to the client via Gmail — one call, done.

invoices:writePro

Gmail & Profile

scan_deals_from_gmail

Scan connected Gmail for brand deal opportunities.

deals:readFree

send_email

Send any email via the creator's connected Gmail. Use for follow-ups, outreach, or custom messages.

deals:writePro

get_profile

Get the authenticated user's profile and account type.

profile:readFree

Partnership Inbox

read_inbox

List inbound brand emails from collab.creedn.com with AI summaries and detected budgets.

deals:readFree

list_partnership_emails

List brand partnership emails with richer filters — unread only, by classification (new_deal, deal_reply, general).

deals:readFree

get_email_details

Get full content (including message body) for a specific partnership email. Use before replying or countering.

deals:readFree

reply_to_brand

Send a reply to a brand email in the partnership inbox.

deals:writePro

action_deal

Accept or decline a brand deal email. Accept auto-creates a deal card in the pipeline.

deals:writePro

counter_brand_deal

Generate an AI counter-offer draft using your rate floor and voice profile. Set auto_send=true to send immediately.

deals:writePro

Agent Memory

get_agent_memory

Read rate floor, niche tags, blocked brands, trust levels.

memory:readFree

update_agent_memory

Update rate floor, niche tags, or block a brand.

memory:writePro

Error Codes

Code

Name

Description

-32700

Parse error

Invalid JSON in request body.

-32601

Method not found

Unknown JSON-RPC method.

-32602

Invalid params

Missing tool name in tools/call.

-32001

Authentication failed

Invalid or expired API key.

-32029

Rate limited

Too many requests. Check Retry-After header.

Protocol Details

Protocol

MCP 2024-11-05

Transport

HTTP JSON-RPC 2.0

Endpoint

POST /api/mcp

Supported Methods

initializetools/listtools/callnotifications/initialized

Ready to connect?

Generate your API key and connect your agent in under 2 minutes.

Generate API Key Create account