Skip to main content
Glama
osintsx

osintsx-mcp

by osintsx
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

osintsx-mcp

An MCP server for the OSINT.SX API.

It lets an AI assistant such as Claude, Cursor or VS Code run OSINT.SX searches for you. It can check an email, phone number, username or name against every source at once, or use one of the single-platform tools.

It runs on your own API key. Each search costs what it costs on the site: 1 credit. A search that finds nothing because most sources failed gives the credit back. Tool searches cost nothing when they find nothing.

Setup

  1. Make an API key at https://osint.sx/keys.

  2. Add the server to your MCP client with that key.

Claude Desktop, Cursor and most clients (claude_desktop_config.json, .cursor/mcp.json):

{
  "mcpServers": {
    "osintsx": {
      "command": "npx",
      "args": ["-y", "osintsx-mcp"],
      "env": { "OSINTSX_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add osintsx --env OSINTSX_API_KEY=YOUR_API_KEY -- npx -y osintsx-mcp

Node.js 20.3 or newer is required.

Related MCP server: Social Media Scraper - Custom MCP Server

Tools

Tool

What it does

search

Checks an email, phone number (+E.164), username or full name against every source, and returns each site where it's registered with the details that site shows.

google_account_lookup

Finds Google accounts and Gaia IDs by email, name or domain, or looks one up by Gaia ID.

microsoft_account_lookup

Finds Microsoft accounts by email, name or domain, or looks one up by CID.

epic_games_lookup

Finds Epic Games accounts by display name, account ID, or the username on a linked platform.

twitter_history

Looks up an X profile's archived history: earlier usernames, names, bios, locations and pictures.

steam_history

Looks up a Steam profile's archived history: earlier names, custom URLs and avatars, and other accounts that held the same custom URL.

instagram_share_trace

Finds the account that shared an Instagram link copied from the app.

tiktok_share_trace

Finds the account that shared a TikTok short link copied from the app.

A call waits up to 50 seconds by default, then returns whatever has come in, and the result says it was cut short. For search, the sources that hadn't answered are cancelled. A single-platform tool keeps running on OSINT.SX after the cut-off, so its credit may still be used. 50 seconds keeps the call under the 60-second timeout many MCP clients use, and in testing almost every source answered within that time.

If your client allows longer calls, set max_wait_seconds (up to 600). Clients that support progress notifications show progress while a search runs.

By default, search leaves out sources that may notify the person. Set include_alerting_sources to include them.

Replies are kept under about 48 KB, so they fit what MCP clients accept. If there are more results than that, the reply says how many were left out. The Google, Microsoft, Epic and share-trace tools return each result's main fields; set include_raw to get everything the source sent.

Settings

Variable

OSINTSX_API_KEY

Required. Your API key.

OSINTSX_API_URL

Optional. Defaults to https://api.osint.sx.

Use responsibly

Only search for people and accounts you have a lawful reason to look into. See the terms.

API reference: https://osint.sx/api

This server cannot be deployed

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

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers