Back to Documentation
MCP Server

Connect your AI agent.

Creedn is MCP-native. Connect any MCP-compatible AI agent to your creator business in under 2 minutes. 20 tools. Real data. No hallucinations.

Quick Start

1

Generate an API Key

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

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

2

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"
      }
    }
  }
}
3

Start using your tools

Your AI agent now has access to your real Creedn data. Try asking it to "list my brand deals" 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 agent can query deals, analytics, revenue, roster, and news but cannot create or modify records.

  • ✓ Read deals, analytics, revenue
  • ✓ Read roster and creator details
  • ✓ Scan Gmail for opportunities
  • ✓ View content calendar and news
  • ✗ Create or update deals
  • ✗ Generate invoices
  • ✗ Schedule content

Pro

Full read + write access. Your agent can autonomously manage your deal pipeline, generate invoices, schedule content, and update agent memory.

  • ✓ Everything in Free
  • ✓ Create and update deals
  • ✓ Generate invoices
  • ✓ Schedule content to calendar
  • ✓ Update agent memory
View pricing →

Tool Reference

20 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 & Analytics

get_revenue_summary

Financial summary: total earned, pending, MoM growth.

revenue:readFree
get_analytics

Platform analytics: followers, engagement, reach.

analytics:readFree

Roster (Agency)

list_roster

List all creators with stats, commission rates, contract status.

roster:readFree
get_creator_detail

Detailed profile and deal history for a roster creator.

roster:readFree
calculate_commission

Calculate agency vs creator splits for a deal value.

roster: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

Content & News

get_content_calendar

Get scheduled and planned content items.

content:readFree
get_niche_news

Fetch trending news articles relevant to a niche.

content:readFree
add_to_calendar

Schedule a content item to the creator's calendar.

content:writePro

Gmail & Profile

scan_deals_from_gmail

Scan connected Gmail for brand deal opportunities.

deals:readFree
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
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 KeyCreate account