NearIQ MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NearIQ MCP Server How visible is my business in AI search?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@neariq/mcp-server
Connect NearIQ competitive intelligence to Claude Desktop, Claude Code, Cursor, Windsurf, and other Model Context Protocol clients.
npm package:
@neariq/mcp-serverRequires: Node.js 18+ and a NearIQ Growth+ API key
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-serverIf you want to test the package manually:
NEARIQ_API_KEY=niq_live_your_key_here npx -y @neariq/mcp-serverGet A NearIQ API Key
Sign in to NearIQ.
Open Settings > API Keys.
Create an API key with the scopes your MCP client should use.
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 |
| Yes | NearIQ API key, usually starting with |
| No | API base URL. Defaults to |
Available Tools
Tool | Description |
| Your business profile, rating, and plan. |
| Address, phone, website, hours, and profile health. |
| Tracked competitors with health, momentum, and financial signals. |
| Deep detail for one competitor. |
| Add a competitor by place ID or manual details. |
| Search businesses before adding a competitor. |
| Your reviews or a competitor's reviews. |
| AI gap analysis against competitors. |
| AI search visibility scores and recommendations. |
| Local search rank tracking results. |
| NAP consistency and citation health. |
| Market leaderboard by rating, reviews, health, or velocity. |
| Generate posts, FAQs, review templates, outlines, and more. |
| Previously generated content. |
| Business alerts and recommendations. |
| Engagement benchmarks and signal grades. |
| AI intelligence report generation. |
| Previously generated reports. |
| Ask NearIQ AI about your business and market data. |
| 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 buildThe package source currently lives in the NearIQ monorepo and is mirrored to the public distribution repository.
License
MIT
Available Tools
20 toolsadd_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
Scored across 20 tools
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.
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.
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.
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
Track competitors' Meta ads, save swipe files and run Meta campaigns from Claude, ChatGPT or Cursor.
Track competitors from your AI assistant: change feed, page snapshots, labels and alerts.
Amazon brand, seller, niche & buy-box intelligence inside your own Claude or ChatGPT.
AI visibility & recommendation monitoring for ChatGPT, Claude, Gemini & Perplexity.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnect 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.1MIT
- AlicenseNot gradedqualityCmaintenanceQuery your Surfa Analytics data using natural language through Claude Desktop, ChatGPT, or any MCP-compatible client. Turn your analytics into insights with AI.3MIT
- AlicenseAqualityBmaintenanceEnables 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.25806 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real-time business intelligence tasks including competitive analysis, website scoring, review analysis, and market research.MIT