For developers and AI agents

API and MCP server: run AI marketing from your own tools

ultimate-marketing.io has a REST API and an MCP server. Start marketing runs from your own tools, pull results and campaign figures into your dashboard, and let AI assistants work with your AI marketing department. Nothing is published without approval.

Try free for 7 days OpenAPI description

Included from Pro and in the free trial · keys under Settings → API & MCP

What you can do with it

Start runs from AI assistants

Tell your agent “Write a LinkedIn post about our new service” – it starts the run, the ultimate-marketing.io agents create the post, and you approve it.

Keep track of approvals

See which runs are waiting for your decision and read the draft and review report without opening the app.

Figures in your own dashboard

Pull campaigns on Meta, Google, LinkedIn and ChatGPT with status, daily budget, spend, clicks and leads via the API.

Build automations

With Zapier, Make, n8n or your own code: for example start a blog article every Monday or post new approvals to Slack.

Connected in two minutes

Log in and create a key under Settings → API & MCP. It starts with umk_ and is shown only once.
Choose the permissions: read is always included, start allows new runs, approve allows decisions at the gate – leave it off if a human should approve.
Add the MCP server to your client or call the REST API with the key in the Authorization header.

MCP server for clients that can set an Authorization header, such as Claude Code, Cursor or your own agents built with the MCP SDK:

{
  "mcpServers": {
    "ultimate-marketing": {
      "type": "http",
      "url": "https://ultimate-marketing.io/api/mcp",
      "headers": {
        "Authorization": "Bearer umk_\u2026"
      }
    }
  }
}

In Claude Code one command is enough:

claude mcp add --transport http ultimate-marketing https://ultimate-marketing.io/api/mcp --header "Authorization: Bearer umk_…"

REST API, for example to start a post:

curl -X POST https://ultimate-marketing.io/api/v1/laeufe \
  -H "Authorization: Bearer umk_…" \
  -H "Content-Type: application/json" \
  -d '{"prozess": "post", "thema": "Neue Leistung vorstellen"}'

MCP tools

Tool	What it does	Permission
get_account	Plan, trial, AI credit and whether the agents are paused by the budget stop	Read
list_offers	Offers or brands of the workspace	Read
list_processes	Marketing processes (e.g. post, blog, campaign) and whether they are in your plan	Read
list_runs	Recent runs, filterable by status – e.g. “freigabe” for everything waiting for you	Read
get_run	One run with draft, agent results and history	Read
list_campaigns	Campaigns on Meta, Google, LinkedIn and ChatGPT with key figures	Read
start_run	Start a process; the result comes to approval	Start
decide_run	Approve, send back or reject at the gate	Approve

REST endpoints

Method	Path	Purpose
GET	/api/v1/konto	Account, plan, credit, budget stop
GET	/api/v1/angebote	Offers
GET	/api/v1/prozesse	Processes and whether they are in your plan
GET	/api/v1/laeufe?status=freigabe	Runs, optionally by status
GET	/api/v1/laeufe/{id}	One run with draft and history
POST	/api/v1/laeufe	Start a run (permission “start”)
POST	/api/v1/laeufe/{id}/entscheidung	Approve, send back, reject (permission “approve”)
GET	/api/v1/kampagnen	Campaigns with key figures

Basis-URL: https://ultimate-marketing.io/api/v1 · openapi.json

Security and control

Keys are stored only as a hash and can be revoked one by one at any time.
Every key has its own permissions; the approve permission is off by default.
At most 60 requests per minute per key.
Plan limits and the budget stop apply exactly as in the app: without credit no runs start.
Every run records the name of the key in its history.
The application and database run in Frankfurt, Germany.

Frequently asked questions

What is an MCP server?

MCP (Model Context Protocol) is an open standard that lets AI assistants and agents use tools of other services. With the ultimate-marketing.io MCP server, an agent can start marketing runs, read results and query campaigns.

Which clients work?

Any MCP client that connects over HTTP and can set an Authorization header with your key, for example Claude Code, Cursor or your own agents built with the MCP SDK. The REST API works with any tool that can send HTTP requests.

Can an AI agent publish without me?

No, as long as the key does not have the approve permission. The agents prepare everything and you decide in the approval traffic light. Giving a key the approve permission is a deliberate choice to automate approvals.

What does the API cost?

The API and MCP server are included from the Pro plan and can be used in the 7-day free trial. Runs use AI credit just like in the app.

Try free for 7 days