Medialister offers a remote MCP (Model Context Protocol) server that lets you search, browse, and manage your Medialister workspace directly from your favorite AI assistant—no need to switch between tabs or copy-paste data.
The MCP server gives your AI assistant access to the core Medialister workflows on both the client side and the publisher side. The assistant signs in with your Medialister account, so it respects the same permissions as the product: if you can't delete a campaign in the UI, the assistant can't either.
Marketplace Search & Discovery—Search publishers by name, domain, or keyword with the full set of marketplace filters: format type (Article, Press Release, Guest Post, etc.), media type, category, location, language, price range, SEO metrics (Ahrefs DR, Semrush traffic), audience country, accepted topics (Crypto, CBD, Gambling, etc.), hyperlink types, turnaround time, permanent placement, and more. Results can be sorted by price, audience, Ahrefs DR, Semrush traffic, estimated views, and other fields. There's also a built-in location lookup that helps resolve ambiguous place names against Medialister's own geo database before they're used as a filter. You can ask things like "find tech news publishers in the US with Ahrefs DR above 50 and price under $500."
Bookmarks & Saved Views—Create bookmark folders, add offers to them, list your existing folders, and see what's inside each one. You can also browse curated public bookmark folders and public saved views maintained by the Medialister team.
Cart—View your current cart and add offers to it with quantity control. When adding an offer, you can link it to a specific campaign, or let it go to your active campaign by default.
Organizations & Account—Check your organization's balance (available and reserved amounts), list all the organizations you belong to along with your role in each, and switch between them without leaving the chat.
Projects & Campaigns—List your projects and campaigns, open any of them for details, and see the project activity feed (member updates, campaign changes, text edits, order status changes). You can create new projects and campaigns with goal, budget, and publishing period, update their settings, delete them (with the usual guardrails—you can't delete the current campaign or the last campaign in a project), and quickly switch the active project or campaign for the assistant to work in.
Orders—See every order you have access to across all organizations in one tree view, or list orders for the active campaign filtered by status (To Publish, In Review, To Make Changes, Articles to Approve, Published, Canceled, Refunded). For any specific order you can pull full details—including conditions, extras, publish date, and placement link—read the chat history, and read the activity log. You can also move orders forward: send an order to review when the content is ready, or approve a placement link once a publisher has delivered it. Orders can be referenced by their public ID (like Q26030039).
Content Management (Texts)—List all texts in a campaign with their statuses and counters, open any text to see its full title and body, create new drafts, delete texts, and attach or detach texts to or from orders in bulk. Attachment behaves exactly like in the product: the text content is copied into the order at attach time, and only orders in "To Publish" can actually receive text changes.
The Medialister MCP server is a remote (cloud-hosted) server, so there's nothing to install on your computer. You just need to point your AI tool to our MCP endpoint URL.
MCP Server URL: https://api.medialister.com/mcp
Claude has native support for remote MCP servers via Connectors.
Open Settings → Connectors in Claude.
Click "Add custom connector" at the bottom.
Enter a name (e.g., "Medialister") and paste the MCP server URL.
Click "Add" to save.
In any new chat, click the "+" button at the bottom-left, then "Connectors", and enable Medialister for the conversation.
You can now ask Claude to search the marketplace, manage campaigns, move orders through review, draft and attach texts, or run publisher workflows—all in natural language.
If you prefer the desktop app, you can add the MCP server via Connectors the same way as on the web. Alternatively, for advanced users, you can edit the config file directly.
Open Claude Desktop → Settings → Connectors.
Click "Add custom connector", enter the name and MCP URL, then click "Add".
Restart Claude Desktop if the connector doesn't appear immediately.
Advanced (config file method): Open the config file at:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following:
{
"mcpServers": {
"medialister": {
"command": "npx",
"args": [
"mcp-remote",
"https://api.medialister.com/mcp"
]
}
}
}
Save and restart Claude Desktop. You should see the MCP server indicator in the chat input area.
Claude Code supports remote MCP servers via the claude mcp add command. Run this in your terminal (not inside Claude Code):
claude mcp add medialister --transport http https://api.medialister.com/mcp
By default, this saves the configuration locally. Use --scope user to make it available across all projects:
claude mcp add medialister --transport http https://api.medialister.com/mcp --scope user
After adding, start a new Claude Code session and type /mcp to verify the Medialister server is connected and see the available tools.
ChatGPT supports remote MCP servers through Developer Mode.
Open Settings → Advanced Settings → Developer Mode and enable it.
Start a new chat. You'll see an option to "Add sources" or manage connectors in the chat input.
Add a new connector with the Medialister MCP URL.
Enable the connector in your chat session.
Once connected, you can ask ChatGPT to search the marketplace, manage your bookmarks, check your balance, review orders, or work with campaign texts.
Note: ChatGPT's MCP support is evolving. Some features like write actions may require confirmation prompts. Check OpenAI's MCP documentation for the latest details.
Google's Gemini CLI supports MCP servers via its settings file.
Open or create ~/.gemini/settings.json in your home directory.
Add the Medialister MCP server:
{
"mcpServers": {
"medialister": {
"url": "https://api.medialister.com/mcp"
}
}
}
Launch Gemini CLI and type /mcp to verify the connection and see available tools.
Note: The Gemini web app does not currently support connecting custom MCP servers. This setup works with the Gemini CLI terminal tool only.
Once connected, try asking your AI assistant things like:
"Search Medialister for technology blogs in the United States under $300 with dofollow links"
"Find me publishers that accept crypto content with Ahrefs DR above 40"
"Show me what's in my cart and what it totals"
"Create a bookmark folder called 'Q2 Campaign' and add these offers to it"
"What's my current balance on Medialister?"
"Find press release placements in Germany with permanent placement and page indexing"
"List my campaigns and switch to the SaaS Launch one"
"Create a new campaign called 'March Outreach' in my main project with a medium budget and monthly publishing"
"Show me all orders in the current campaign that are waiting for review"
"Open order Q26030039 and read the latest chat messages and activities"
"Draft a press release in the campaign texts, mark it ready, and attach it to my three To Publish orders"
"Send order Q26030039 to review"
"List my media projects and archive the ones I don't need anymore"
The marketplace search supports filtering by: format type, media type, category, location, language, badges (New, Best Price, Editor's Choice, etc.), price range, Ahrefs DR, Semrush organic traffic, audience size, audience by country, hyperlink type and amount, turnaround time, permanent placement, page indexing, homepage announcement, video support, unique text requirement, and accepted sensitive topics (Crypto, CBD, Gambling, Adult, Betting, Dating, Loans, Medicine, Alcohol, Smoking, Trading, Politics News).
If you've connected Medialister's MCP server to an AI tool like Claude, ChatGPT, or Gemini, paste this reference guide into your chat to get noticeably better results. It's written for AI models—not humans—and explains how Medialister is structured, what our terminology means, and where the edge cases live. Without this context, your AI has to guess at things like how roles affect what it can see, or why marketplace searches sometimes return loose matches, which leads to inaccurate answers and wasted tool calls. Paste it into a new chat before your first question, or save it once as a project instruction or custom GPT prompt so every conversation starts already informed.
Connection fails or no tools appear—Make sure your Medialister account has MCP access enabled. Contact support if you're unsure.
Authentication errors—If the server requires authentication (OAuth), follow the login prompts in your AI tool. Claude and ChatGPT handle OAuth flows automatically when configured correctly.
Action blocked by permissions—Some actions (creating or deleting campaigns, sending orders to review, approving placements, managing media projects) require admin or manager rights on your organization, matching the same rules as the Medialister UI. If the assistant says it can't do something, check your role on that organization first.
Stale data or timeouts—The MCP server queries live data. If you experience slow responses, try simplifying your search filters or reducing the number of results per page.
Tool not found—Make sure the MCP URL is entered correctly, without extra spaces or trailing characters. Restart your AI tool after making configuration changes.