Model Context Protocol

Plug your AI agent into the OSINT library

A free, read-only MCP server that lets Claude, ChatGPT (Codex), Cursor, Gemini or any MCP client search 1,300+ OSINT tools the way investigators do — by the data you have and the data you need — and find which tool to run next.

Endpoint (Streamable HTTP): https://osintlibrary.com/api/mcp

01 Add the server

Same URL everywhere. Pick your client:

Install everywhere (one command)

npx add-mcp https://osintlibrary.com/api/mcp

Detects Claude, Cursor, VS Code, Codex, Gemini CLI… and writes each client's config for you.

Claude Code

claude mcp add --transport http osintlibrary https://osintlibrary.com/api/mcp

Claude Desktop

https://osintlibrary.com/api/mcp

Settings → Connectors → Add custom connector → paste this URL. Claude Desktop adds remote servers from the Connectors UI; claude_desktop_config.json is for local stdio servers (use the mcp-remote bridge below for that).

Cursor (and clients that take a remote url)

{
  "mcpServers": {
    "osintlibrary": { "url": "https://osintlibrary.com/api/mcp" }
  }
}

VS Code (Copilot)

// .vscode/mcp.json
{
  "servers": {
    "osintlibrary": { "type": "http", "url": "https://osintlibrary.com/api/mcp" }
  }
}

Gemini CLI

// ~/.gemini/settings.json
{
  "mcpServers": {
    "osintlibrary": { "httpUrl": "https://osintlibrary.com/api/mcp" }
  }
}

stdio-only client, or ChatGPT / Codex fallback

npx mcp-remote https://osintlibrary.com/api/mcp

Bridges the remote server over stdio for any client that can't add a Streamable HTTP server directly.

02 Ask away

Your agent can now reason over the catalogue. Try prompts like:

  • I have an email address — which OSINT tools can I run?
  • Find free tools for company investigation.
  • I just ran Shodan. What should I run on the results?
  • Which tools turn a domain into subdomains?
  • What Dutch (NL) OSINT tools are there?
  • Give me a free alternative to Maltego.

What it exposes

search_tools

Find tools by free text, by a concept they accept (input) or produce (output), by investigation type, by country, or by pricing.

get_tool

Full record for one tool — description, license, links, platforms and every input/output concept.

list_investigation_types

The investigation categories (person, company, attack surface…) with tool counts.

list_concepts

The data types tools take in and put out — emails, usernames, domains, hashes — to chain by data flow.

list_countries

Countries that have nation-specific tools (registries, licence-plate, people-search) with active-tool counts.

find_tool_chain

Given a tool, the tools that consume its outputs: the natural next steps in a workflow.

find_alternatives

Curated alternatives to a tool — for when it's paid, down, or unavailable in your region.

MCP directories

The endpoint above works in any client right now — just paste it, no registry needed. For broader discovery, these are the major public MCP directories where agents browse for servers:

Read-only and rate-limited. The server only reads the public catalogue — the same data behind the website and the REST API. No write access, no secrets, fail-closed. The tools it returns are third-party softwarethat OsintLibrary does not build, host, or security-vet — verify a tool's integrity before running it and use OSINT lawfully. See the Terms. Open-source client coming soon.