Adsmcp MCP server

AdsMCP

The ad monetization MCP server for AI applications.

AdsMCP is Adgentek's hosted Model Context Protocol server that enables AI agents and conversational interfaces to serve contextually relevant ads automatically — based on conversation context, user intent, and placement opportunity.

Built on a full ad server stack. Bring live demand from Adgentek, bring your own direct-sold campaigns, or both. No ad tech expertise required.

Before You Start

You need an Adgentek publisher account, an API key, and at least one active AI Surface before ads will serve.

Create your publisher account →

Setup checklist

1. Create your account at app.adgentek.ai/publishers/auth
2. Create an AI Surface — in the publisher dashboard, go to Inventory → Surfaces and add at least one surface (e.g. conversational, search, voice). A surface defines where ads can appear and sets your floor eCPM.
3. Generate an API key — in the publisher dashboard, go to Settings → API Keys and create a key (prefixed adgt_). This key authenticates all MCP requests.

Your account is considered Active once at least one surface is enabled.

Connect

{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

This is the only configuration needed. All MCP-compatible clients support this URL + Headers pattern — no local packages or environment variables required.

Platform-Specific Configuration

The connection config is identical across platforms. Only the file location and wrapper key differ.

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json  (Windows)
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code

// ~/.claude/settings.json
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

VS Code (Copilot MCP)

// .vscode/mcp.json
{
  "servers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

OpenAI Codex

{
  "mcpServers": {
    "adgentek-ads": {
      "url": "https://mcp.adgentek.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Available Tools

ads.serve

Serves a contextual ad based on the current conversation. Returns the highest-yield ad available for the given context, or null if no ad matched.

Required parameters: conversationId, userKey, surface

Optional parameters: messages, intent, sentiment, depth, language, geo, preferHtml, extras

Shortened. The full README is on GitHub.