MCP integration

MentionsAPI in ChatGPT Plus

Wire MentionsAPI into ChatGPT Plus via the Custom GPT Action interface. Once added, ChatGPT can call /v1/check, /v1/discover, and /v1/compare as tools — no SDK install, no MCP server, just an OpenAPI schema paste.

Setup steps

  1. Open ChatGPT GPT Editor and click Configure → Actions → Create new action.
  2. Paste the OpenAPI schema below into the Schema field.
  3. Set Authentication to API Key → Bearer and paste your lvk_live_... key.
  4. Save. ChatGPT Plus can now call MentionsAPI tools directly inside any conversation using this Custom GPT.

OpenAPI schema (paste this)

json
{
  "openapi": "3.1.0",
  "info": {
    "title": "MentionsAPI",
    "version": "1.0.0",
    "description": "Brand monitoring across AI search surfaces"
  },
  "servers": [{ "url": "https://api.mentionsapi.com" }],
  "paths": {
    "/v1/check": {
      "post": {
        "summary": "Check brand mention",
        "operationId": "checkBrand",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["query", "brand", "mode"],
                "properties": {
                  "query": { "type": "string" },
                  "brand": { "type": "string" },
                  "mode":  {
                    "type": "string",
                    "enum": ["quick","perplexity_live","chatgpt_live","gemini_live","ai_overview","ai_mode","bing_copilot","all_live"]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/discover": {
      "post": {
        "summary": "Discover target queries for a brand",
        "operationId": "discover",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["brand"],
                "properties": {
                  "brand":    { "type": "string" },
                  "industry": { "type": "string" },
                  "count":    { "type": "integer", "minimum": 1, "maximum": 100 }
                }
              }
            }
          }
        }
      }
    },
    "/v1/compare": {
      "post": {
        "summary": "Compare two brands",
        "operationId": "compareBrands",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["query", "brand_a", "brand_b"],
                "properties": {
                  "query":   { "type": "string" },
                  "brand_a": { "type": "string" },
                  "brand_b": { "type": "string" }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": { "type": "http", "scheme": "bearer" }
    }
  },
  "security": [{ "bearerAuth": [] }]
}

Example prompts

  • "Use checkBrand to see if HubSpot is mentioned for 'best CRM for small business' in mode all_live."
  • "Run discover on Notion in industry 'productivity software' with count 25 and summarize the top intents."
  • "Compare HubSpot vs Salesforce for the query 'best CRM for startups'."

Notes

  • Calls debit your wallet at the standard rates.
  • For programmatic use (Claude Code, Cursor, Windsurf), use the MCP server at /docs/mcp.