Adwords MCP

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.