Model Context Protocol

Wire any AI agent into
MarketingOS

17 typed tools across CRM and Dashboard. Authenticated, scoped, rate-limited. Live in under five minutes — Claude Desktop, Cursor, or your own MCP client.

Read the docsOpenAPI 3.1 schema

From Claude Desktop

Add the gateway to your MCP client config, then ask naturally.

{
  "mcpServers": {
    "marketing-os": {
      "url": "https://mcp.marketing.blueforge.studio/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

Then ask Claude:

"Show me my top 10 leads by score and summarize why each one is hot."

Behind the scenes: crm.people.list with fields=id,name,email,score,score_breakdown.

17 tools, 3 domains

CRM

crm.people.list

Cursor-paginated list of people

crm.people.upsert

Create or update by identity (email/phone)

crm.people.merge

Merge two people (touchpoints follow survivor)

crm.people.score_explain

Lead score breakdown

crm.companies.list

Companies with filter + pagination

crm.segments.materialize

Materialize a segment into an audience

crm.campaigns.list

Campaign CRUD

crm.events.list

Touchpoint events

crm.stats.summary

Aggregate CRM stats

crm.webhooks.create

Webhook subscriptions

Dashboard

dashboard.apps.list

Marketing apps in your portfolio

dashboard.apps.create

Register a new app

dashboard.posts.list

Content posts across apps

dashboard.posts.create

Create a post

dashboard.campaigns.publish_all

Publish all pending posts for a campaign

dashboard.insights.summary

Portfolio KPI rollup

dashboard.channels.stats

Per-channel engagement stats

System

system.whoami

Authenticated user identity + scopes

Authentication

API keys with scoped JWT

Generate an API key from the CRM Settings page. The gateway verifies the argon2id-hashed key, mints a short-lived JWT scoped to the key's permissions, and forwards requests to CRM or Dashboard with the JWT in a session cookie.

read— list / get / summary / stats / health
write— create / update / delete / publish
admin— API key CRUD, webhook subscriptions

Ready to wire it up?

Mint a key from your CRM dashboard, drop the config into Claude Desktop or Cursor, and start calling tools.

Full setup guide