io.github.outris-dev-user/outris-identity-mcp

Official8 tools

by outris-dev-org · Python

Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.

Resolve identities from phone/email across 31+ services globally and in India.

Topics

identitymcpmobile

Captured live from the server via tools/list.

check_online_platforms

**What it does:** Checks if a phone number is registered on major global platforms (Amazon, Instagram, Snapchat). **Input:** Phone number (with or without country code). **Returns:** Registration status (true/false) for each specific platform. **Best for:** Digital footprint analysis, verifying if a number is "real" and active on social/shopping apps. Cost: 1 credit

Parameters (1)

phonestringrequired
Phone number (with or without country code)

check_digital_commerce_activity

**What it does:** Checks if a phone number has been used for any digital commerce activity (ecommerce, travel, quick-commerce). **Input:** Phone number (Indian numbers only, add ISD code infront). **Returns:** Boolean flags for overall commerce types, activity timeline, and demographics if available. **Best for:** Assessing if a phone number belongs to a real, active consumer vs. a throwaway number. Cost: 1 credit

Parameters (2)

phonestringrequired
Phone number (with or without country code)
include_demographicsboolean
Include age/gender estimation (default: true)

get_identity_profile

**What it does:** Comprehensive identity report. Fetches names, emails, addresses, metadata, and risk scores in one go . **Input:** Phone number. **Returns:** Complete JSON profile containing all linked entities. **Best for:** Deep investigations where you need the "full picture" immediately. Understand if similar names, addresses appear, then that gives more confidence Cost: 3 credits

Parameters (1)

phonestringrequired
Phone number

get_name

**What it does:** identifying the owner name of a phone number. **Input:** Phone number (with or without country code). **Returns:** List of full names linked to this phone with confidence scores. **Best for:** KYC verification, caller ID, finding out "who called me". Cost: 2 credits

Parameters (1)

phonestringrequired
Phone number

get_email

**What it does:** Finds email addresses linked to a phone number. **Input:** Phone number. **Returns:** List of email addresses with confidence scores. **Best for:** Digital footprint analysis, finding contact details, or cross-referencing identities. Cost: 2 credits

Parameters (1)

phonestringrequired
Phone number

get_address

**What it does:** Finds physical addresses associated with a phone number. **Input:** Phone number. **Returns:** List of addresses with metadata (e.g., "shipping", "billing", "home") and dates. **Best for:** Fraud investigation, delivery verification, and location analysis. Cost: 2 credits

Parameters (1)

phonestringrequired
Phone number

get_alternate_phones

Get other phone numbers belonging to the same person. Returns: List of alternate phone numbers linked through shared identities (same name, email, or address). Use when: User wants to find all phones associated with a person. Example queries: - "What other phones does this person have?" - "Find alternate numbers for 9876543210" - "Are there other phones linked to this one?" Cost: 2 credits

Parameters (1)

phonestringrequired
Phone number

check_breaches

**What it does:** Checks if a phone number or email has been exposed in known data breaches. **Input:** Email address OR Phone number. **Returns:** List of breaches (for email) or breach categories (for phone), including dates. **Best for:** Security audits, checking if a user's data is compromised ("Have I Been Pwned" style checks). Cost: 1 credit

Parameters (2)

identifierstringrequired
Email address or phone number to check
identifier_typestring
Type of identifier: 'email' or 'phone' (auto-detected if not specified)

README.md4 KBView on GitHub

Outris Identity MCP Server

Outris Identity is a Model Context Protocol (MCP) server that lets AI agents investigate phone numbers and emails - find linked identities, check platform registrations, and detect data breaches.

Version 2.0 - Now with Streamable HTTP, SSE, and STDIO support! 🚀

Features

🔍 Identity Resolution: Find names, emails, addresses linked to phone numbers
🌐 Platform Checks: Detect registration on 31+ platforms (India) + 3 global
🛒 Commerce Activity: Check ecommerce, travel, quick-commerce activity
🚨 Breach Detection: Check if phone/email appears in known breaches
🌍 Global + India: Full India coverage, partial global support
📡 Multiple Transports: Streamable HTTP (new), SSE (legacy), STDIO (local)
🔐 Secure: API key authentication, credit-based rate limiting
🚀 Ready for Registry: Meet all MCP official registry requirements

Quick Start

Option 1: Cloud Deployment (Fastest) ☁️

Step 1: Get API Key from Outris Portal

Step 2: Configure Claude Desktop

Edit claude_desktop_config.json:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "outris-identity": {
      "command": "npx",
      "args": [
        "-y", 
        "mcp-remote", 
        "https://mcp-server.outris.com/http",
        "--transport", 
        "streamable-http",
        "--header", 
        "Authorization=Bearer YOUR_API_KEY"
      ]
    }
  }
}

Step 3: Restart Claude and start investigating!

Option 2: Local Installation 🏠

bash

git clone https://github.com/outris/outris-identity-mcp.git
cd outris-identity-mcp

pip install -r requirements.txt
python -m mcp_server --http
# Server runs on http://localhost:8000

Option 3: Docker 🐳

bash

docker build -t outris-identity .
docker run -e OUTRIS_API_KEY="your_key" -p 8000:8000 outris-identity

See SETUP.md for detailed configuration instructions.

Available Tools

Tool	Credits	Use Case
get_identity_profile	3	Complete profile: names, emails, addresses, documents
get_name	2	Names linked to phone
get_email	2	Emails linked to phone
get_address	2	Addresses (ecommerce, banking, etc.)
get_alternate_phones	2	Other phones for same person
check_online_platforms	1	Social media/app registrations
check_digital_commerce_activity	1	Ecommerce/quick-commerce activity
check_breaches	1	Data breach detection

Transports

Transport	URL	Use Case	Status
Streamable HTTP	`POST /http`	Cloud, Claude Desktop	✅ PRIMARY
SSE	`GET /sse`	Legacy clients, proxies	⚠️ Supported
STDIO	`python -m mcp_server`	Local CLI, direct integration	🟢 Native

Documentation

📖 Setup Guide - Installation & configuration
🔧 Tool Reference - Complete tool documentation
🏗️ Architecture - System design & transports
💳 Credit System - Pricing & quotas

Example Usage

bash

# Test the server
curl https://mcp-server.outris.com/health

# List available tools
curl https://mcp-server.outris.com/tools

# Execute a tool
curl -X POST "https://mcp-server.outris.com/http" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"check_online_platforms",
      "arguments":{"identifier":"+919876543210"}
    }
  }'

MCP Registry Listing

This server is registered on the official MCP registry: https://registry.modelcontextprotocol.io/

Type: Streamable HTTP + SSE + STDIO
Auth: Bearer token (API key)
Region: Global + India optimized

License

MIT - See LICENSE file for details

Support & Community

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Built with: Official MCP SDK • FastAPI • PostgreSQL • Neon

Maintained by: Outris Technologies

Install

claude_desktop_config.json

{
  "mcpServers": {
    "outris-identity-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-server.outris.com/http"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.