Connect Medialister to Your AI Assistant via MCP

Medialister offers a remote MCP (Model Context Protocol) server that lets you search, browse, and manage our marketplace directly from your favorite AI assistant—no need to switch between tabs or copy-paste data.

What Can You Do with the Medialister MCP Server

The MCP server gives your AI assistant access to multiple tools that cover the core client-side workflows in Medialister.

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. This means you can ask your AI 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 view 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, add offers to it (with quantity control), and list your campaigns. When adding to cart, you can specify which campaign the offer should be linked to.

Account Info—Check your organization's balance (available and reserved amounts), view campaigns with their goals and project info, and verify the server connection is healthy.

Setting Up the Medialister MCP Server

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 (claude.ai—Web & Mobile)

Claude has native support for remote MCP servers via Connectors.

1. Open Settings → Connectors in Claude.

2. Click "Add custom connector" at the bottom.

3. Enter a name (e.g., "Medialister") and paste the MCP server URL.

4. Click "Add" to save.

5. 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, check your cart, or manage bookmarks—all in natural language.

Claude

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.

1. Open Claude Desktop → Settings → Connectors.

2. Click "Add custom connector", enter the name and MCP URL, then click "Add".

3. 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 (Terminal)

Claude Code supports remote MCP servers via the claude mcp add command.

Run this in your terminal (not inside Claude Code):

claude mcp addmedialister --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

ChatGPT supports remote MCP servers through Developer Mode.

1. Open Settings → Advanced Settings → Developer Mode and enable it.

2. Start a new chat. You'll see an option to "Add sources" or manage connectors in the chat input.

3. Add a new connector with the Medialister MCP URL.

4. Enable the connector in your chat session.

Once connected, you can ask ChatGPT to search the Medialister marketplace, manage your bookmarks, or check your balance.

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.

Gemini CLI

Google's Gemini CLI supports MCP servers via its settings file.

1. Open or create ~/.gemini/settings.json in your home directory.

2. Add the Medialister MCP server:

{
  "mcpServers": {
    "medialister": {
      "url": "https://api.medialister.com/mcp"
    }
  }
}

3. 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.

Example Prompts

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"

• "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 their goals"

• "Search for publishers similar to TechCrunch"

Available Filters Reference

The marketplace search supports filtering by: format type, media type, category, location, language, badges (New, Best Price, 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).

Troubleshooting

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.

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.