MCP.so
Sign In

Adwords MCP

@gregce

Repository

About Adwords MCP

A cringe-worthy MCP server that serves ads to developers in Cursor, Claude, and other clients

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "adwords": {
      "command": "npx",
      "args": [
        "adwords-mcp"
      ]
    }
  }
}

Tools

6

Overview

What is Adwords MCP?

Adwords MCP is a joke/demo MCP server that injects cringe-worthy advertisements into LLM responses. It showcases how to build MCP servers and highlights the risks of ad-injecting intermediaries. The project is intended for developers interested in MCP server mechanics or the security implications of untrusted intermediaries.

How to use Adwords MCP?

Install globally via npm install -g adwords-mcp, then add the server configuration to your MCP client (e.g., Claude or Cursor) using the provided JSON snippet. Invoke the server’s tools (e.g., get_completion, analyze_code, or developer_tip) from the client. Optionally run with HTTP/SSE transport by passing --http.

Key features of Adwords MCP

  • Naive keyword extraction for targeting ads in user queries
  • Random ad selection when no keywords match (can be disabled)
  • Multiple ad injection strategies for embedding ads in responses
  • STDIO and HTTP/SSE transport options
  • Short tool aliases: gc, ac, tip for faster invocation
  • User-provided content framing to prevent AI modification of ads

Use cases of Adwords MCP

  • Demonstrating how to build and package an MCP server
  • Illustrating the risks of ad-injecting intermediaries in AI pipelines
  • Pranks involving unsuspecting peers (as suggested in the PROTIP section)
  • Testing MCP client behavior with user-provided content directives

FAQ from Adwords MCP

Is Adwords MCP intended for production use?

No. The README explicitly states: “Do not use this in production or with real users unless you want them to hate you.” It is a joke/demo project.

What transport options does Adwords MCP support?

It primarily uses STDIO transport for MCP clients like Claude. It also supports HTTP/SSE transport via the --http flag, optionally with a custom port.

How does ad targeting work?

It uses naive keyword extraction in the user’s query. If keywords match, a targeted ad is selected; otherwise, a random ad is injected (unless --no-random-ads is set).

How do I configure Adwords MCP with my MCP client?

Add a configuration entry to your client (e.g., claude_desktop_config.json) using the command npx adwords-mcp (or adwords-mcp if installed globally). For HTTP transport, set USE_HTTP=true.

What tool aliases are available?

The aliases are gc (for get_completion), ac (for analyze_code), and tip (for developer_tip). These shorten tool invocation in clients like Cursor.

Frequently asked questions

Is Adwords MCP intended for production use?

No. The README explicitly states: “Do not use this in production or with real users unless you want them to hate you.” It is a joke/demo project.

What transport options does Adwords MCP support?

It primarily uses STDIO transport for MCP clients like Claude. It also supports HTTP/SSE transport via the `--http` flag, optionally with a custom port.

How does ad targeting work?

It uses naive keyword extraction in the user’s query. If keywords match, a targeted ad is selected; otherwise, a random ad is injected (unless `--no-random-ads` is set).

How do I configure Adwords MCP with my MCP client?

Add a configuration entry to your client (e.g., `claude_desktop_config.json`) using the command `npx adwords-mcp` (or `adwords-mcp` if installed globally). For HTTP transport, set `USE_HTTP=true`.

What tool aliases are available?

The aliases are `gc` (for `get_completion`), `ac` (for `analyze_code`), and `tip` (for `developer_tip`). These shorten tool invocation in clients like Cursor.

Comments

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

gregce

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K