Skip to main content
Glama
NearIQ MCP Server

NearIQ MCP Server

Official
by NearIQ

@neariq/mcp-server

Connect NearIQ competitive intelligence to Claude Desktop, Claude Code, Cursor, Windsurf, and other Model Context Protocol clients.

What It Does

The NearIQ MCP server lets AI tools query your competitive intelligence through NearIQ's public v1 API. It exposes tools for your business profile, competitors, reviews, rank tracking, citations, AI visibility, market intelligence, content, alerts, reports, and AI chat.

The server runs locally over stdio. It does not store your API key; your MCP client passes the key through the NEARIQ_API_KEY environment variable at runtime.

Related MCP server: Surfa MCP Server

Install

Most MCP clients can run the package directly with npx, so you usually do not need a global install:

npx -y @neariq/mcp-server

If you want to test the package manually:

NEARIQ_API_KEY=niq_live_your_key_here npx -y @neariq/mcp-server

Get A NearIQ API Key

  1. Sign in to NearIQ.

  2. Open Settings > API Keys.

  3. Create an API key with the scopes your MCP client should use.

  4. Copy the key into your MCP client configuration as NEARIQ_API_KEY.

Configure Your MCP Client

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "neariq": {
      "command": "npx",
      "args": ["-y", "@neariq/mcp-server"],
      "env": {
        "NEARIQ_API_KEY": "niq_live_your_key_here"
      }
    }
  }
}

Claude Code

Add this to your .mcp.json:

{
  "mcpServers": {
    "neariq": {
      "command": "npx",
      "args": ["-y", "@neariq/mcp-server"],
      "env": {
        "NEARIQ_API_KEY": "niq_live_your_key_here"
      }
    }
  }
}

Cursor

Add this to .cursor/mcp.json:

{
  "mcpServers": {
    "neariq": {
      "command": "npx",
      "args": ["-y", "@neariq/mcp-server"],
      "env": {
        "NEARIQ_API_KEY": "niq_live_your_key_here"
      }
    }
  }
}

Windsurf

Add this to your Windsurf MCP settings:

{
  "mcpServers": {
    "neariq": {
      "command": "npx",
      "args": ["-y", "@neariq/mcp-server"],
      "env": {
        "NEARIQ_API_KEY": "niq_live_your_key_here"
      }
    }
  }
}

Environment Variables

Variable

Required

Description

NEARIQ_API_KEY

Yes

NearIQ API key, usually starting with niq_live_.

NEARIQ_BASE_URL

No

API base URL. Defaults to https://app.neariq.io.

Available Tools

Tool

Description

get_business_profile

Your business profile, rating, and plan.

get_business_details

Address, phone, website, hours, and profile health.

list_competitors

Tracked competitors with health, momentum, and financial signals.

get_competitor_detail

Deep detail for one competitor.

add_competitor

Add a competitor by place ID or manual details.

search_businesses

Search businesses before adding a competitor.

get_reviews

Your reviews or a competitor's reviews.

get_gap_analysis

AI gap analysis against competitors.

get_ai_visibility

AI search visibility scores and recommendations.

get_rank_checks

Local search rank tracking results.

get_citations

NAP consistency and citation health.

get_market_leaderboard

Market leaderboard by rating, reviews, health, or velocity.

generate_content

Generate posts, FAQs, review templates, outlines, and more.

list_content

Previously generated content.

get_alerts

Business alerts and recommendations.

get_behavioral_signals

Engagement benchmarks and signal grades.

generate_report

AI intelligence report generation.

list_reports

Previously generated reports.

ask_neariq

Ask NearIQ AI about your business and market data.

get_keyword_suggestions

AI keyword suggestions for local SEO.

Example Prompts

What are my top three competitors doing better than me?
Generate a Google Business Profile post about our summer promotion.
How visible is my business in AI search, and what should I fix first?

Troubleshooting

NEARIQ_API_KEY environment variable is required

Your MCP client did not pass the API key into the server process. Recheck the env block in your client configuration and restart the client.

API 401 Or 403

Confirm the key is active, belongs to the right NearIQ workspace, and has the scopes required by the tool you are calling. API access requires a plan that includes NearIQ API usage.

Tools Do Not Appear

Restart your MCP client after editing the configuration. If your client supports remote MCP servers, you can also use the hosted endpoint documented at https://docs.neariq.io/guides/mcp-server.

Development

npm install
npm run build

The package source currently lives in the NearIQ monorepo and is mirrored to the public distribution repository.

License

MIT

Available Tools

20 tools
add_competitorA

Add a new competitor to track. Provide either a Google place_id or manual details.

Inputs: name (required), address, place_id, website_url.

ask_neariqB

Ask the NearIQ AI assistant a question about your business, competitors, market, or strategy. The AI has full context of your dashboard data.

Inputs: message (required), context.

generate_contentC

Generate AI content: GBP posts, social posts, blog outlines, FAQ, review response templates, landing pages, and more.

Inputs: type (required), topic (required), tone, length, +1 more.

generate_reportB

Generate an AI intelligence report with executive summary, priority actions, and competitor insights.

Inputs: lenses.

get_ai_visibilityA

Check how visible your business is in AI search engines (ChatGPT, Gemini, Perplexity, Claude). Shows scores per engine and recommendations.

Inputs: days.

get_alertsB

Get business alerts including rating drops, new competitor reviews, ranking changes, and AI recommendations.

Inputs: type, limit, unread.

get_behavioral_signalsA

Get engagement signals and benchmarks: response rate, review velocity, photo count, posting frequency, and competitor comparison.

Inputs: no named parameters.

get_business_detailsB

Get extended business details including address, phone, website, hours, and Google Business Profile health.

Inputs: no named parameters.

get_business_profileA

Get your business profile including name, category, location, rating, review count, and plan details.

Inputs: no named parameters.

get_citationsA

Check NAP (Name, Address, Phone) consistency across business directories. Shows citation health score.

Inputs: no named parameters.

get_competitor_detailC

Get detailed info about a specific competitor including reviews, products, hiring signals, and ads.

Inputs: competitor_id (required), include.

get_gap_analysisA

Get AI-powered gap analysis comparing your business to competitors. Identifies strengths, weaknesses, and actionable recommendations.

Inputs: no named parameters.

get_keyword_suggestionsA

Get AI-powered keyword suggestions for local SEO with search volume and difficulty estimates.

Inputs: seed, count.

get_market_leaderboardB

Get the competitive leaderboard for your market segment. Shows ranked businesses by health score, rating, or review count.

Inputs: city, sort, limit, category.

get_rank_checksC

Get local search rank tracking results showing your position across different keywords and locations.

Inputs: limit, keyword.

get_reviewsA

Get reviews for your business or a specific competitor. Includes sentiment analysis and rating distribution.

Inputs: sort, limit, competitor_id.

list_competitorsA

List all tracked competitors with health scores, momentum, and financial signals.

Inputs: sort, limit.

list_contentB

List previously generated content with optional type filter.

Inputs: type, limit.

list_reportsB

List previously generated intelligence reports.

Inputs: limit.

search_businessesA

Search public business listings by name, category, or location before adding a competitor.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 20 tools

    Disambiguation5/5

    Each tool targets a distinct function: adding/list competitors, getting details, reviews, reports, content generation, AI visibility, etc. There is no significant overlap; even similar-sounding tools like get_business_profile and get_business_details differ in scope.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (e.g., add_competitor, get_alerts, generate_content) and use snake_case throughout. No mixed conventions or inconsistent verb styles.

    Tool Count4/5

    20 tools is slightly high but appropriate for a comprehensive business intelligence platform covering competitors, SEO, content, and reporting. Each tool has a clear role, though a few could potentially be consolidated.

    Completeness4/5

    The tool surface covers core workflows: competitor tracking, AI analysis, reviews, content generation, and reporting. Minor gaps exist (e.g., no delete/update competitor tool, no direct review management), but agents can work around them via other tools like generate_content for response templates.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connect AI assistants to live Meta Ads, GA4, and Google Search Console data. 100% local, credentials machine-locked and encrypted. Supports Claude Desktop, Cursor, Windsurf, Cline, and more.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Query your Surfa Analytics data using natural language through Claude Desktop, ChatGPT, or any MCP-compatible client. Turn your analytics into insights with AI.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to monitor and analyze a brand's visibility across ChatGPT, Claude, Perplexity, and Google AI Overviews, providing insights, recommendations, and competitive analysis without switching tabs.
      25
      806 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform real-time business intelligence tasks including competitive analysis, website scoring, review analysis, and market research.
      MIT