Skip to main content
Glama

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.

CI npm version License: MIT

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:

  1. Go to Bing Webmaster Tools

  2. Sign in and verify your site

  3. Go to Settings → API Access

  4. 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 citelens

Or 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

bing_list_sites

List all verified sites

bing_get_traffic

Get traffic and ranking stats

bing_get_query_stats

Get search query (keyword) statistics

bing_get_page_stats

Get page-level statistics

bing_get_crawl_stats

Get crawl statistics over time

bing_get_crawl_issues

Get crawl errors and issues

bing_get_url_info

Get index status for a specific URL

bing_list_sitemaps

List submitted sitemaps

bing_submit_sitemap

Submit a new sitemap

bing_get_url_submission_quota

Check remaining URL submission quota

bing_submit_url

Submit a single URL for indexing

bing_submit_url_batch

Submit multiple URLs (max 500)

IndexNow (Instant URL Indexing)

Tool

Description

indexnow_generate_key

Generate a new IndexNow key

indexnow_validate_key

Check if your key file is accessible

indexnow_submit_url

Submit a URL via IndexNow

indexnow_submit_batch

Submit up to 10,000 URLs at once

AI Citation Analysis

Tool

Description

ai_import_citation_report

Import CSV/XLSX export from Bing AI Performance

ai_get_top_cited_pages

Get pages with most AI citations

ai_get_citation_trend

View citation trend over time

ai_get_top_queries

Get top grounding queries

ai_get_top_intents

Get top intents from queries

ai_get_top_topics

Get top topics from queries

ai_compare_with_bing_stats

Compare AI citations with Bing search stats

ai_get_import_history

View history of imported reports

Historical Snapshots

Tool

Description

snapshot_stats

Save current stats for historical comparison

list_snapshots

List all saved snapshots

diff_stats

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

BING_WEBMASTER_API_KEY

Yes*

Your Bing Webmaster API key

CITELENS_ACCESS_TOKEN

Yes*

OAuth access token (alternative to API key)

CITELENS_REFRESH_TOKEN

No

OAuth refresh token for auto-refresh

CITELENS_CLIENT_ID

No

OAuth client ID (required for auto-refresh)

CITELENS_CLIENT_SECRET

No

OAuth client secret (required for auto-refresh)

CITELENS_TOKEN_FILE

No

Custom path to token.json (default: ~/.citelens/token.json)

INDEXNOW_KEY

No

Your IndexNow key (can also pass per-request)

CITELENS_DATA_DIR

No

Data directory (default: ~/.citelens)

*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 dev

Roadmap

  • 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 tools
ai_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

    B3.3/5.0

    Scored across 27 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Provides AI agents full access to Bing Webmaster Tools API for site management, URL submission, sitemaps, traffic stats, keyword research, and URL blocking.
      24
      8 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Bing 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.
      63
      59 PyPI
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables 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.
      34
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to manage Bing Webmaster Tools, including site verification, URL submissions, traffic analytics, crawl monitoring, and keyword analysis through natural language.
      62
      MIT