Skip to content
MCP server

recomention

Ask whether AI engines recommend your product and read the full visibility report

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.1.5
Listing updated
3 days ago

About recomention

recomention is a freemium MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.

This server lets a coding agent answer a question like whether ChatGPT recommends a product for a given category. It wraps the recomention JSON API: an agent can browse public AI rankings, get suggested buyer questions, start a report, poll until it finishes and read the result. A finished report gives each engine's count of answers that named the product, who was named instead, the sources the engines read and a fix list. Engines that could not run are listed as skipped rather than counted against you.

Two ways to connect exist. The npm package runs locally over stdio with an API key from the account's Developers page; public rankings and suggested questions work without one. The hosted endpoint signs in with OAuth and needs no key, with reading and paid starts approved separately and starts using report credits only.

Starting a report is never free: the request must name its funding, either an agency credit or your own provider keys on an Agent plan. Those keys are read from the server's environment, never from tool arguments. API limits are 60 requests per key per minute and 10 report starts per key per hour.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.recomention.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.recomention.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.recomention.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.recomention.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.recomention.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.recomention.com/mcp"
    }
  }
}

Configuration

  • RECOMENTION_API_KEYAPI key from your recomention account (Developers). Needed for reports; public rankings and suggested questions work without it.
  • RECOMENTION_BASE_URLAPI origin. Must be https:// (http:// only for localhost).
  • OPENAI_API_KEYOptional. Your own OpenAI key, used only for reports started with funding "byok" (needs an active Agent plan).
  • ANTHROPIC_API_KEYOptional. Your own Anthropic key, used only for reports started with funding "byok" (needs an active Agent plan).
  • PERPLEXITY_API_KEYOptional. Your own Perplexity key, used only for reports started with funding "byok" (needs an active Agent plan).
  • GEMINI_API_KEYOptional. Your own Gemini key, used only for reports started with funding "byok" (needs an active Agent plan).
  • XAI_API_KEYOptional. Your own xAI (Grok) key, used only for reports started with funding "byok" (needs an active Agent plan).
  • DATAFORSEO_API_KEYOptional. DataForSEO login:password for Google AI Overview, used only for reports started with funding "byok" (needs an active Agent plan).

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

recomention_rankings_list
Lists the public AI rankings; no key needed.
recomention_rankings_get
Returns one ranking with the questions and products named.
recomention_suggest_prompts
Suggests buyer questions from fixed templates for a domain and category.
recomention_report_start
Starts a report funded by credits or your own provider keys.

What it does

Public rankings
Lists AI rankings and shows each ranked product as named in n of m answers.
Suggested questions
Generates buyer questions from fixed templates without a model call.
Report start and status
Starts a paid report and polls until it completes.
Detailed results
Returns per-engine scores, competitors named, sources and a fix list.
Bring your own keys
Runs reports on your OpenAI, Anthropic, Gemini and other keys on an Agent plan.
Hosted OAuth option
Connect Claude or ChatGPT with sign-in instead of an API key.

Good for

  • Check whether AI engines recommend a product for a buyer question
  • See which competitors are named instead
  • Draft buyer questions to test a category
  • Read the sources that engines cited
  • Generate a fix list for improving AI visibility

Pricing

Freemium

Rankings are free; reports need agency credits or an Agent plan; prices not published

Prices change. Check recomention.com before you buy.

recomention FAQ

Do I need an API key?

Only for reports. Public rankings and suggested questions work without one; the hosted server uses OAuth instead.

What does starting a report cost?

It spends one agency credit for a Full report, or runs on your own provider keys with an Agent plan; prices are not published.

Are there rate limits?

The API allows 60 requests per key per minute and 10 report starts per key per hour.

What does it need to run locally?

Node.js 20 or newer.

Is recomention free?

recomention has a free plan, with paid plans for more usage or features.

How do I add recomention to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.recomention.com/mcp

What are the best alternatives to recomention?

The closest alternatives to recomention are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to recomention

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data