How do I use mcp-osint?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-osint Ukraine conflict news" 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.

mcp-osint

by DanDaDaDanDan

Overview Schema Source Related Servers Discussions Admin

TypeScript

mcp-osint

MCP server for Claude Code providing access to OSINT data sources:

Government - Data.gov, LegiScan, CourtListener, Census Bureau
Research - OpenAlex, Semantic Scholar, PubMed, CORE
Corporate - SEC EDGAR (10-K, 10-Q), FRED (economic data)
Compliance - OpenSanctions (sanctions, PEPs)
News/Knowledge - GDELT, Wikidata
Infrastructure - crt.sh (SSL certificates, subdomains)
Web - Firecrawl (URL scraping with HTML + markdown)

Setup

1. Get API Keys

Required keys:

LegiScan - legiscan.com/user/register
CourtListener - courtlistener.com/api
FRED - fred.stlouisfed.org/docs/api
Firecrawl - firecrawl.dev

Optional keys (higher rate limits):

Data.gov - api.data.gov/signup
Census - census.gov/data/developers
CORE - core.ac.uk/services/api
OpenSanctions - opensanctions.org/api

Free (no key): SEC EDGAR, GDELT, Wikidata, crt.sh, OpenAlex, Semantic Scholar, PubMed

2. Install & Build

cd mcp-osint
npm install
npm run build

3. Add to Claude Code

Using the CLI:

claude mcp add -s user -t stdio mcp-osint \
  -e LEGISCAN_API_KEY=your-key \
  -e COURTLISTENER_API_KEY=your-key \
  -e FRED_API_KEY=your-key \
  -e FIRECRAWL_API_KEY=your-key \
  -- node /path/to/mcp-osint/dist/index.js

Or manually add to your MCP settings (~/.claude/settings.json or VS Code settings):

{
  "mcpServers": {
    "mcp-osint": {
      "command": "node",
      "args": ["/path/to/mcp-osint/dist/index.js"],
      "env": {
        "LEGISCAN_API_KEY": "your-key",
        "COURTLISTENER_API_KEY": "your-key",
        "FRED_API_KEY": "your-key",
        "FIRECRAWL_API_KEY": "your-key",
        "POLITE_EMAIL": "you@example.com"
      }
    }
  }
}

Related MCP server: OSINT MCP Server

Tools

osint_search

Search across 14 OSINT data sources. Returns results with available resources.

Parameter	Type	Required	Description
`query`	string	Yes	Natural language search query
`source`	string		Force a specific connector (see table below)
`jurisdiction`	string		State code (e.g., `"CA"`) or `"US"`
`year`	number		Filter to specific year
`limit`	number		Max results (default: 10)

Examples:

"EPA air quality data California"       → Data.gov
"Michigan renewable energy bill 2024"   → LegiScan
"Brown v. Board of Education"           → CourtListener
"population by county Texas"            → Census
"machine learning medical diagnosis"    → OpenAlex/PubMed
"Apple 10-K filing 2024"                → SEC EDGAR
"GDP quarterly growth rate"             → FRED
"Russian sanctions oligarchs"           → OpenSanctions
"Ukraine conflict news"                 → GDELT
"microsoft.com subdomains"              → crt.sh

osint_preview

Preview a resource's schema and sample data before fetching.

Parameter	Type	Required	Description
`resource_id`	string	Yes	Resource ID from osint_search
`row_limit`	number		Sample rows for tabular data (default: 5)
`max_bytes`	number		Max bytes for text preview (default: 4000)

osint_get

Fetch data from a resource ID or URL. Automatically handles web pages, PDFs, and structured data.

Parameter	Type	Required	Description
`target`	string	Yes	URL (http/https) or resource_id from osint_search
`output_path`	string		Path to save binary files (required for PDFs)
`question`	string		What to extract (e.g., "all data", "key findings")
`summarize`	boolean		If true with question, returns only relevant content (default: false)
`columns`	string[]		Specific columns to return (resource_id only)
`filters`	object[]		Filter conditions (resource_id tabular data only)
`limit`	number		Max rows for tabular data (default: 100)

Behavior by target type:

Target	Behavior
Web URL	Returns markdown + raw HTML + SHA256 hash via Firecrawl
PDF URL	Downloads to `output_path`, returns file path + SHA256
Binary URL	Downloads to `output_path`, returns file path + SHA256
Resource ID	Extracts data via connector with optional filtering

Examples:

osint_get target="https://example.com/article"
osint_get target="https://example.com/paper.pdf" output_path="./downloads/paper.pdf"
osint_get target="pubmed:paper:12345:abstract" question="key findings"

osint_list_sources

List all data sources and their configuration status.

Environment Variables

Variable	Required	Default	Description
`LEGISCAN_API_KEY`	Yes	-	LegiScan legislative data
`COURTLISTENER_API_KEY`	Yes	-	CourtListener judicial data
`FRED_API_KEY`	Yes	-	FRED economic data
`FIRECRAWL_API_KEY`	Yes	-	Firecrawl web scraping
`DATAGOV_API_KEY`		-	Data.gov (higher limits)
`CENSUS_API_KEY`		-	Census Bureau (higher limits)
`CORE_API_KEY`		-	CORE open access papers
`OPENSANCTIONS_API_KEY`		-	OpenSanctions compliance data
`POLITE_EMAIL`		-	Email for polite API usage (OpenAlex, PubMed, SEC)
`MCP_DEBUG`		`true`	Debug logging; set to `"false"` to disable
`MCP_LOG_DIR`		`./logs`	Log directory; set to `"none"` to disable

Connectors

Connector	Source	Data Types	Key Required
`data_gov`	Data.gov	Datasets, resources	Recommended
`legiscan`	LegiScan	Bills, votes, sponsors	Yes
`courtlistener`	CourtListener	Cases, opinions, dockets	Yes
`census`	Census Bureau	Demographics, statistics	Recommended
`openalex`	OpenAlex	Papers, authors, citations	No
`semantic_scholar`	Semantic Scholar	Papers, authors, citations	No
`pubmed`	PubMed/NCBI	Medical papers, abstracts	No
`core`	CORE	Open access papers	Recommended
`sec_edgar`	SEC EDGAR	10-K, 10-Q, company filings	No
`fred`	FRED	Time series, economic data	Yes
`opensanctions`	OpenSanctions	Sanctions, PEPs	Yes
`gdelt`	GDELT	News, global events	No
`wikidata`	Wikidata	Entities, knowledge graph	No
`crt_sh`	crt.sh	SSL certificates, subdomains	No

Development

npm install       # Install dependencies
npm run build     # Compile TypeScript
npm run dev       # Watch mode
npm start         # Run server

Testing

# Test connector metadata and identifiers
npx tsx test/test-all-connectors.ts

# Test data retrieval (downloads files)
npx tsx test/test-data-retrieval.ts

# Test Firecrawl HTML+Markdown
npx tsx test/test-firecrawl.ts

# Run comprehensive MCP tool tests
npx tsx test/test-mcp-scenarios.ts

Architecture

src/
├── index.ts              # MCP server entry point
├── types.ts              # Shared types
├── intent.ts             # Query parsing and routing
├── router.ts             # Connector selection
├── logger.ts             # Logging utility
├── cache.ts              # SQLite + file caching
├── retry.ts              # Retry with backoff
└── connectors/
    ├── base.ts           # Base connector class
    ├── data-gov.ts       # Data.gov/CKAN
    ├── legiscan.ts       # LegiScan
    ├── courtlistener.ts  # CourtListener
    ├── census.ts         # Census Bureau
    ├── openalex.ts       # OpenAlex
    ├── semantic-scholar.ts
    ├── pubmed.ts         # PubMed/NCBI
    ├── core.ts           # CORE
    ├── sec-edgar.ts      # SEC EDGAR
    ├── fred.ts           # FRED
    ├── opensanctions.ts  # OpenSanctions
    ├── gdelt.ts          # GDELT
    ├── wikidata.ts       # Wikidata
    ├── crt-sh.ts         # crt.sh
    └── firecrawl.ts      # Firecrawl

License

MIT

Available Tools

4 tools

osint_getA

Fetch data from a resource ID or URL.

Automatically handles:

URLs → web pages (markdown + raw HTML), PDFs (downloaded), binaries
Resource IDs → structured data from connectors with optional filtering

Always returns full raw content with SHA256 hash for verification. Use 'summarize: true' with a question to extract only relevant content.

For local archival, provide output_path:

Web pages: saves raw.html, content.md, links.json, metadata.json to output_path/
PDFs/binaries: saves file to output_path

Inputs: target (required), limit, columns, filters, +3 more.

osint_list_sourcesA

List all available OSINT data sources and their status.

Returns for each connector:

Name and health (healthy, degraded, unavailable)
API key configuration status
Required environment variable if missing

Use to check which sources are available before searching.

Inputs: no named parameters.

osint_previewA

Preview a resource's schema and sample data before fetching.

For tabular data: shows column names, types, and sample rows. For documents: shows text excerpt and structure. For APIs: shows available parameters and endpoints.

Use to confirm a resource has what you need before calling osint_get.

Inputs: resource_id (required), max_bytes, row_limit.

osint_searchA

Search across 14 OSINT data sources. Returns results with available resources.

Auto-routes to the best source, or use source to query a specific connector.

Sources: data_gov, legiscan, courtlistener, census, openalex, semantic_scholar, pubmed, core, sec_edgar, fred, opensanctions, gdelt, wikidata, crt_sh

Examples:

"EPA air quality data California" → Data.gov
"Michigan renewable energy bill 2024" → LegiScan
"Brown v. Board of Education" → CourtListener
"population by county Texas" → Census
"machine learning medical diagnosis" → OpenAlex/PubMed
"Apple 10-K filing 2024" → SEC EDGAR
"GDP quarterly growth rate" → FRED
"Russian sanctions oligarchs" → OpenSanctions
"Ukraine conflict news" → GDELT
"microsoft.com subdomains" → crt.sh

Inputs: query (required), year, limit, source, +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.4/5.0

Scored 2026-07-30 00:35 across 4 tools

Disambiguation5/5

Each tool has a clear, non-overlapping purpose: listing sources, searching, previewing schemas, and fetching data. No ambiguity between them.

Naming Consistency5/5

All tools follow a consistent 'osint_verb' pattern (preview, list_sources, search, get), with predictable naming.

Tool Count5/5

Four tools cover the essential OSINT workflow (list, search, preview, get) without excess or deficiency.

Completeness5/5

The tool surface covers the full lifecycle: discover sources, search, preview data, and fetch. No obvious gaps for the intended use case.

Resources

Related MCP Connectors

Crimson Crawler
com.crimsoncrawler
Enrich, search, assess, and manage threat intelligence through 80+ typed MCP tools.
Security Search Research & Data
1
https://crimsoncrawler.com/mcp/v1
BedrockTap
com.bedrocktap
One MCP server over 253 data sources: Reddit, LinkedIn, YouTube, G2, search and AI answers.
Search Social Media Research & Data
1
https://api.bedrocktap.com/mcp
Novada MCP
io.github.NovadaLabs
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
Browser Automation Web Scraping Search
13
https://mcp.novada.com/mcp
NS Pros Data API
io.github.ocean1547-ui
The world's public data, one API. License-cleared public data sources for agents, via MCP and REST.
Open Data Search
1
https://api.nspros.ca/mcp

Related MCP Servers

mcp-osint-server
Search Web Scraping Shell Access
himanshusanecha
F
license
Not graded
quality
D
maintenance
MCP server to perform various OSINT tasks by leveraging common network reconnaissance tools.
Updated 2 years ago (2025-03-12 16:44 UTC)
48
-
OSINT MCP Server
Security Search Research & Data
CloudWaddie
A
license
D
quality
D
maintenance
A comprehensive MCP server providing tools for IP, domain, email, and image-based open-source intelligence. It integrates services like Shodan, VirusTotal, and HaveIBeenPwned to facilitate advanced security research and data gathering.
Updated 8 months ago (2026-03-09 08:18 UTC)
56
108 npm
ISC
omega-mcp-server
Penetration Testing Research & Data
Ekoelogan
A
license
Not graded
quality
D
maintenance
MCP server that exposes 108+ omega-cli OSINT tools for reconnaissance, web analysis, threat intelligence, and reporting, enabling AI assistants to perform comprehensive open-source intelligence tasks.
Updated 7 months ago (2026-04-01 03:17 UTC)
MIT
OSINT MCP Server
osintukraine
A
license
C
quality
D
maintenance
MCP server for the OSINT Intelligence Platform, enabling AI assistants to interact with Telegram intelligence archives via 65 tools for search, entity analysis, event tracking, social graph, and platform monitoring.
Updated a year ago (2025-12-25 20:08 UTC)
71
2
MIT

mcp-osint

Setup

1. Get API Keys

2. Install & Build

3. Add to Claude Code

Tools

osint_search

osint_preview

osint_get

osint_list_sources

Environment Variables

Connectors

Development

Testing

Architecture

License

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

mcp-osint-server

OSINT MCP Server

omega-mcp-server

OSINT MCP Server