Athenous

MCP · AI tool integration

Marketing operations inside your AI assistant

Q: How do I connect Athenous to my AI tool?

Create an API key in Settings → API keys (Pro, Agency, or Enterprise, REST API scope). In your AI tool add a remote MCP server at https://mcp.athenous.io/mcp and send header Authorization: Bearer with that key. Then ask it to list connectors, schedule a post, or sync analytics.

Q: Do I install anything?

No. Add https://mcp.athenous.io/mcp in the AI tool and send your API key as Authorization: Bearer.

Q: Do I connect Instagram or LinkedIn inside the AI?

No. Connect networks in Athenous Connections. The AI tool uses those connector IDs when it schedules or publishes.

Connect Athenous over MCP. Claude, Cursor, ChatGPT, and any compatible client can schedule posts, sync analytics, and inspect campaigns—using your existing Connections and API key.

URL https://mcp.athenous.io/mcp

In the AI tool, add that URL and send Authorization: Bearer ath_… with a key from Settings → API keys (Pro+).

View setup Get API key

Compatible clients

Claude
ChatGPT
Cursor
Claude Code
Windsurf

Any MCP-compatible host. Social and ad OAuth stay in Athenous Connections; your assistant calls them through the server.

REST API reference →

How it works

Three steps from key to conversation

Same Client API as the dashboard—exposed to your AI over MCP.

01
Issue an API key

Create a key with REST API scope in Settings → API keys.
02
Register the MCP server

In your AI tool, add https://mcp.athenous.io/mcp and the header Authorization: Bearer ath_….
03
Ask in natural language

Schedule, publish, sync metrics, and list connectors from the same thread you already work in.

Setup

Use Athenous from your AI tool

Same URL and header in every tool. Paste your key where it says ath_xxxxxxxx.

{
  "mcpServers": {
    "athenous": {
      "url": "https://mcp.athenous.io/mcp",
      "headers": {
        "Authorization": "Bearer ath_xxxxxxxx"
      }
    }
  }
}

Cursor

IDE

Open Settings → MCP or the project file .cursor/mcp.json.
Paste the config above, replace the key, and reload MCP.

Claude

Connectors

Open Settings → Connectors and add a custom connector.
URL https://mcp.athenous.io/mcp. Header Authorization: Bearer ath_….

Claude Code

Terminal

claude mcp add --transport http athenous https://mcp.athenous.io/mcp --header "Authorization: Bearer ath_xxxxxxxx"

ChatGPT

Connectors

Add a connector with URL https://mcp.athenous.io/mcp.
If it asks for a header, use Authorization: Bearer ath_….

If that screen only offers HTTP Actions, use the REST API with the same key.

Windsurf & others

Remote MCP

Open MCP server settings and add a remote server.
Use the URL and Authorization header from the config above.

Capabilities

What the assistant can execute

Posts, Campaigns, and Connectors—invoked from conversation instead of the UI.

Create & schedule

Draft or schedule across connected networks and set publish time without opening the calendar.

Publish on demand

Push live now or leave scheduled—the same publish path the app uses.

Sync analytics

Pull post and campaign metrics so the assistant can summarize performance in-thread.

List connectors

Enumerate destinations before scheduling. OAuth remains in Athenous Connections.

Inspect campaigns

Open paid campaigns beside organic work from a single assistant session.

Plan-aware access

Pro+ API key and workspace quotas—MCP is a thin layer over the REST Client API.

Examples

Prompts that map to real actions

Each line is one tool call. The panel is the kind of result Athenous returns.

Claude

“Schedule this LinkedIn update for Friday at 14:00 UTC.”

schedule_post

Scheduled on LinkedIn for Friday, 14:00 UTC.

Cursor

“Which accounts are connected, and what’s scheduled this week?”

list_connectors

3 accounts connected. 4 posts already scheduled this week.

Any client

“Sync analytics for that post and summarize engagement.”

sync_post_analytics

Reach 12.4k, 860 reactions, 140 link clicks. Up 18% this week.

ChatGPT

“Save this as a draft, then publish it to Instagram now.”

publish_post

Draft saved, then that post went live on Instagram.

Claude Code

“List my campaigns and open the summer launch.”

get_campaign

Summer launch opened. Active, $4,200 spent.

Windsurf

“Sync analytics for the summer launch and tell me spend versus results.”

sync_campaign_analytics

$4,200 spent, 18.6k results, about 2.4× return.

FAQ

Common questions

How do I connect Athenous to my AI tool?

Create an API key in Settings → API keys. In the AI tool, add https://mcp.athenous.io/mcp and send Authorization: Bearer with that key. Then ask it to list connectors, schedule a post, or sync analytics.

Do I need an API key?

Yes. Pro, Agency, or Enterprise with the REST API scope. Send it as Authorization: Bearer ath_… on https://mcp.athenous.io/mcp. Do not commit the key.

What can my AI do through the MCP server?

List connectors, create and schedule posts, publish, sync post and campaign analytics, and inspect campaigns—via the same Client API as the dashboard.

Which AI tools work with Athenous MCP?

Any tool that can add a remote MCP server: Claude, Claude Code, Cursor, ChatGPT, Windsurf, and custom agents.

Do I install anything?

No. Add https://mcp.athenous.io/mcp in the AI tool and send your API key as Authorization: Bearer ath_….

Do I connect Instagram or LinkedIn inside the AI?

No. Connect networks in Athenous Connections. Your AI tool uses those connectorId values when it schedules or publishes through MCP.

Need a walkthrough? Book a demo and we’ll configure your first client with you.

Athenous

Your AI stack. Your marketing workspace.

Issue a key, register the MCP server, and run Posts and Campaigns from the assistant you already use.

Get API key View setup