CiteLens MCP
Click 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., "@CiteLens MCP import my AI citation report from ~/Downloads/AIPageStatsReport.csv"
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.
CiteLens MCP
See how AI is citing your website. An open-source MCP server that gives AI assistants access to your Bing Webmaster Tools data, IndexNow submission, and AI citation analysis.
Why CiteLens?
As AI-powered search becomes mainstream, understanding how your content is being cited by AI is crucial for SEO. CiteLens bridges the gap by letting you:
Access your Bing Webmaster Tools data directly from Claude, Cursor, or any MCP client
Submit URLs via IndexNow for instant indexing across search engines
Analyze AI citation reports exported from Bing to understand which pages AI is citing
Track historical trends since Bing stats update weekly with no date parameters
Related MCP server: Bing Webmaster MCP Server
Quick Start
Prerequisites
Get your Bing Webmaster API key:
Go to Bing Webmaster Tools
Sign in and verify your site
Go to Settings → API Access
Generate your API key
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"citelens": {
"command": "npx",
"args": ["-y", "citelens-mcp"],
"env": {
"BING_WEBMASTER_API_KEY": "your-api-key-here",
"INDEXNOW_KEY": "your-indexnow-key"
}
}
}
}Cursor
Add to your Cursor MCP settings (Settings → MCP):
{
"mcpServers": {
"citelens": {
"command": "npx",
"args": ["-y", "citelens-mcp"],
"env": {
"BING_WEBMASTER_API_KEY": "your-api-key-here",
"INDEXNOW_KEY": "your-indexnow-key"
}
}
}
}Hermes Agent
Install the CiteLens plugin:
hermes plugins install deliberatelabs-stack/citelens-mcp --subdir hermes
hermes plugins enable citelensOr add to your Hermes config:
mcp_servers:
citelens:
command: npx
args: ["-y", "citelens-mcp"]
env:
BING_WEBMASTER_API_KEY: ${BING_WEBMASTER_API_KEY}
INDEXNOW_KEY: ${INDEXNOW_KEY}Available Tools
Bing Webmaster Tools
Tool | Description |
| List all verified sites |
| Get traffic and ranking stats |
| Get search query (keyword) statistics |
| Get page-level statistics |
| Get crawl statistics over time |
| Get crawl errors and issues |
| Get index status for a specific URL |
| List submitted sitemaps |
| Submit a new sitemap |
| Check remaining URL submission quota |
| Submit a single URL for indexing |
| Submit multiple URLs (max 500) |
IndexNow (Instant URL Indexing)
Tool | Description |
| Generate a new IndexNow key |
| Check if your key file is accessible |
| Submit a URL via IndexNow |
| Submit up to 10,000 URLs at once |
AI Citation Analysis
Tool | Description |
| Import CSV/XLSX export from Bing AI Performance |
| Get pages with most AI citations |
| View citation trend over time |
| Get top grounding queries |
| Get top intents from queries |
| Get top topics from queries |
| Compare AI citations with Bing search stats |
| View history of imported reports |
Historical Snapshots
Tool | Description |
| Save current stats for historical comparison |
| List all saved snapshots |
| Compare two snapshots to see changes |
Example Prompts
Once configured, try asking your AI assistant:
"Show me my top 10 pages by impressions"
"Which of my pages are being cited by AI? Import the AI report from ~/Downloads/mysite_AIPageStatsReport.csv"
"Submit these new blog posts to IndexNow: [urls]"
"Compare my keyword rankings from last week to this week"
"What crawl issues does the search engine see on my site?"
"How has my AI citation count trended over the past month?"
Authentication
Option 1: API Key (Simple)
Set the BING_WEBMASTER_API_KEY environment variable. This is the easiest option for personal use.
Option 2: OAuth Token File (Advanced)
For OAuth 2.0 authentication, create ~/.citelens/token.json:
{
"access_token": "your-access-token",
"refresh_token": "your-refresh-token",
"expires_at": 1700000000000,
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}Override the token file location with CITELENS_TOKEN_FILE.
Option 3: Environment Variables (OAuth)
For containers or CI/CD:
export CITELENS_ACCESS_TOKEN="your-access-token"
export CITELENS_REFRESH_TOKEN="your-refresh-token"
export CITELENS_TOKEN_EXPIRES_AT="1700000000000"
export CITELENS_CLIENT_ID="your-client-id"
export CITELENS_CLIENT_SECRET="your-client-secret"Configuration
Environment Variable | Required | Description |
| Yes* | Your Bing Webmaster API key |
| Yes* | OAuth access token (alternative to API key) |
| No | OAuth refresh token for auto-refresh |
| No | OAuth client ID (required for auto-refresh) |
| No | OAuth client secret (required for auto-refresh) |
| No | Custom path to token.json (default: |
| No | Your IndexNow key (can also pass per-request) |
| No | Data directory (default: |
*Either BING_WEBMASTER_API_KEY or CITELENS_ACCESS_TOKEN (or token file) is required.
Security Notes
API keys are sensitive. Never commit them to version control.
Token files are created with mode 600 (owner read/write only).
OAuth tokens auto-refresh when client credentials are provided, with the refreshed tokens written back to the token file.
Local SQLite database stores only your own imported reports and snapshots in
~/.citelens/.
How It Works
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude/Cursor │────▶│ CiteLens MCP │────▶│ Bing Webmaster │
│ Hermes │ │ (stdio) │ │ Tools API │
└─────────────────┘ └────────┬─────────┘ └─────────────────┘
│
▼
┌────────────────┐
│ Local SQLite │
│ (snapshots & │
│ citations) │
└────────────────┘Development
# Clone and install
git clone https://github.com/deliberatelabs-stack/citelens-mcp
cd citelens-mcp
npm install
# Run tests
npm test
# Type check
npm run typecheck
# Build
npm run build
# Run locally
BING_WEBMASTER_API_KEY=your-key npm run devRoadmap
Bing Webmaster Tools integration
IndexNow submission
AI citation report import and analysis
Historical snapshot diffing
OAuth 2.0 support with auto-refresh
Hermes Agent plugin
Hosted version with web dashboard (no API key sharing needed)
Google Search Console integration
Automated weekly snapshots
Citation alerts and monitoring
Multi-site dashboard
Interested in a hosted version? Let us know!
Trademark Disclaimer
This project is not affiliated with, endorsed by, or sponsored by Microsoft Corporation. This tool works with Bing Webmaster Tools via its official API.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see LICENSE for details.
Questions? Open an issue or reach out on X.
Available Tools
27 toolsai_compare_with_bing_statsB
Compare AI-cited pages with Bing search page statistics. Requires both AI citation import and page stats snapshot.
Inputs: siteUrl (required).
ai_get_citation_trendA
Get citation trend over time from imported AI Performance Overview reports.
Inputs: siteUrl (required).
ai_get_import_historyC
Get history of imported AI citation reports.
Inputs: siteUrl (required), reportType.
ai_get_top_cited_pagesC
Get the top cited pages from imported AI citation reports.
Inputs: siteUrl (required), limit.
ai_get_top_intentsC
Get top intents aggregated from AI Search Queries reports.
Inputs: siteUrl (required), limit.
ai_get_top_queriesB
Get top grounding queries from imported AI Search Queries reports.
Inputs: siteUrl (required), limit.
ai_get_top_topicsB
Get top topics aggregated from AI Search Queries reports.
Inputs: siteUrl (required), limit.
ai_import_citation_reportA
Import an AI citation report (CSV or XLSX) exported from Bing Webmaster Tools AI Performance section. Automatically detects report type (PageStats, Overview, or SearchQueries).
Inputs: siteUrl (required), filePath (required).
bing_get_crawl_issuesA
Get crawl issues/errors for a site from Bing. Shows URLs with problems, HTTP codes, and issue types.
Inputs: siteUrl (required).
bing_get_crawl_statsA
Get crawl statistics for a site from Bing. Shows pages crawled, errors, and index status over time.
Inputs: siteUrl (required).
bing_get_page_statsB
Get page-level statistics for a site from Bing. Shows impressions, clicks, and positions per page. Data updates weekly.
Inputs: siteUrl (required).
bing_get_query_statsA
Get search query (keyword) statistics for a site from Bing. Shows impressions, clicks, and positions. Data updates weekly.
Inputs: siteUrl (required).
bing_get_trafficA
Get traffic and ranking statistics for a site from Bing. Data updates weekly.
Inputs: siteUrl (required).
bing_get_url_infoC
Get index status and crawl information for a specific URL from Bing.
Inputs: url (required), siteUrl (required).
bing_get_url_submission_quotaA
Get the remaining URL submission quota for a site in Bing. Daily limit is 10,000 URLs per domain.
Inputs: siteUrl (required).
bing_list_sitemapsC
List all sitemaps submitted for a site in Bing Webmaster Tools.
Inputs: siteUrl (required).
bing_list_sitesA
List all sites verified in Bing Webmaster Tools for the current API key
Inputs: no named parameters.
bing_submit_sitemapC
Submit a sitemap to Bing Webmaster Tools.
Inputs: feedUrl (required), siteUrl (required).
bing_submit_urlB
Submit a single URL to Bing for indexing. Use IndexNow as primary method; this is a fallback.
Inputs: url (required), siteUrl (required).
bing_submit_url_batchA
Submit multiple URLs to Bing for indexing (max 500 per batch). Use IndexNow as primary method; this is a fallback.
Inputs: urls (required), siteUrl (required).
diff_statsC
Compare two snapshots to see what changed between them.
Inputs: date1 (required), date2 (required), siteUrl (required), statsType (required).
indexnow_generate_keyB
Generate a new IndexNow key. The key must be placed in a .txt file on your site root.
Inputs: length.
indexnow_submit_batchB
Submit multiple URLs via IndexNow (max 10,000 per submission) for instant indexing.
Inputs: host (required), urls (required), key, keyLocation.
indexnow_submit_urlA
Submit a single URL via IndexNow for instant indexing by multiple search engines.
Inputs: url (required), key, keyLocation.
indexnow_validate_keyA
Validate that an IndexNow key file is accessible and contains the correct key.
Inputs: host (required), key.
list_snapshotsB
List all saved snapshots for a site.
Inputs: siteUrl (required).
snapshot_statsA
Take a snapshot of current Bing stats and store locally for historical comparison. Data updates weekly, so snapshot weekly.
Inputs: siteUrl (required), statsType.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
Most tools target a distinct source+metric, and descriptions explicitly separate near-duplicates (bing_submit_url vs indexnow_submit_url as primary/fallback; ai_get_top_queries vs bing_get_query_stats by data source). The only real friction is the parallel Bing/IndexNow submission pairs, which rely on the descriptions to disambiguate rather than the names.
Strong domain-prefixed verb_noun pattern: bing_*, indexnow_*, ai_* with clear verbs (get/list/submit/import/compare). Minor deviations are the un-prefixed snapshot tools (list_snapshots, snapshot_stats, diff_stats), which break the pattern but remain readable.
27 tools is on the heavy side, but the surface spans three distinct integrations (Bing Webmaster stats, IndexNow submission, AI citation analytics) plus snapshotting, so most tools earn their place. It is nonetheless large enough that agents must pick sub-domains carefully, making it borderline rather than well-scoped.
IndexNow lifecycle is complete (key generate/validate, single/batch submit), Bing covers sites, traffic, query/page/crawl stats, sitemaps and URL submission with quota, and AI citation import plus aggregation views are broad. Gaps are modest: no snapshot delete/rename, and no Bing keyword-research or link data operations.
Maintenance
Related MCP Connectors
Google Search Console, Bing, Yandex and IndexNow for AI assistants, with live SEO analyses.
Bing Webmaster, IndexNow and Google Search Console for AI: rankings, indexing gaps, AI crawlers.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Connect AI agents to your AI visibility and SEO data: competitors, citations, GSC, GA4, Bing.
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides AI agents full access to Bing Webmaster Tools API for site management, URL submission, sitemaps, traffic stats, keyword research, and URL blocking.248 npm1MIT
- AlicenseAqualityBmaintenanceBing Webmaster Tools and IndexNow for AI agents: traffic, indexing, crawl issues, inbound links, keywords. Direct writes are off by default; changes go through a plan a person applies.6359 PyPI1MIT
- AlicenseCqualityBmaintenanceEnables AI assistants to query Bing Webmaster Tools data such as site verification, traffic analytics, and search performance, with read-only defaults and configurable site access controls.34MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to manage Bing Webmaster Tools, including site verification, URL submissions, traffic analytics, crawl monitoring, and keyword analysis through natural language.62MIT