Your own AI tools and the API
Connect Claude, ChatGPT, Cursor or another MCP client to your brands, or make an API key for your own systems and the command line; choose what it may do, and see what it changed.
What it is
On the Agency plan you can connect your own AI tool (Claude, ChatGPT, Cursor and other tools that support MCP, the Model Context Protocol) to THEMARKETING. The tool can then read your brand profile, search your knowledge base with citations, look at products, keywords, topics, versions, the calendar and results, and, if you allow it, prepare work for you. Other plans see an upgrade link when they try to connect.
Connecting a tool
- In your AI tool, add a custom connector or remote MCP server with the address https://app.themarketing.app/api/mcp.
- The tool opens a THEMARKETING page in your browser. Sign in if asked.
- Check the tool's name and the address it returns to. The name is what the tool says about itself, so cancel if you don't recognise the address.
- Choose Read only or Read and write, and All brands (including brands you add later) or only the brands you tick, then click Allow.
What it can and can't do
With read and write access the tool can create topics, add keywords and style rules, move publish times of approved pieces, start drafting a planned topic, and send a piece in review back to the writer with a comment. Everything goes through the same checks as the app: drafting uses a topic of your plan and rewrites count as usual, and every draft stops at review.
It can never approve, publish, export or delete content, and it can't change your account, plan, billing or platform connections. You approve and publish in THEMARKETING yourself, on Review. Brands over your plan's brand limit are read-only for the tool too.
Seeing and removing connections
On Login & security, under Apps, every connected tool shows its access, its brands and its recent changes, including any that no longer applied. Click Sign out to disconnect it at once. Changing your password or signing out other devices disconnects every tool too. A connection lasts 90 days from its last use; after that the tool asks you to allow it again.
API keys for your own systems
For scripts and systems of your own (Zapier, your CMS, a reporting tool), make an API key on Login & security, under API keys: give it a name, choose read only or read and write, and all brands or some. The key is shown once, so copy it then. It calls the THEMARKETING API at https://app.themarketing.app/api/open/v1 (the API description is at /api/open/v1/openapi.json) and can do exactly what a connected AI tool can, with the same limits; an MCP client that takes a fixed header can use a key too. You can have up to 10 keys. Each one shows its last four characters, when it was last used and its recent changes, and Revoke stops it at once. Changing your password or signing out other devices revokes every key, and a key that goes unused for 90 days expires.
The command line
The THEMARKETING CLI uses the same API from a terminal. With Node.js 20 or later, install it with `npm install -g @themarketing/cli`, run `themarketing login` and paste an API key. If the key may use more than one brand, pick the default with `themarketing use <brand>`. `themarketing help` lists the commands, for example `themarketing topics list`, `themarketing topics create "<title>" --keyword "<keyword>" --lang en-US` or `themarketing versions rewrite <version id> "<comment>"`; results print as JSON. The key is saved in your own config folder, readable only by you. `themarketing logout` forgets it on that computer; revoking it on Login & security stops it everywhere.