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

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

{
  "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 🏠

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 🐳

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 & Modular Stacks

A curated set of intent tools — one per common identity/KYC/compliance journey — instead of a flat list of hundreds of raw endpoints. See TOOLS.md for details.

Modular Stacks

You can launch or query a focused MCP surface tailored strictly for your product domain:

• kyb (7 tools): MCA VPD filings (AOC-4/MGT-7), UBO, GSTIN, PAN, Bank account validation, 58-body regulatory enforcement.
• ubo (5 tools): Beneficial ownership tree unravelling, regulatory sanctions, company profile, person due-diligence.
• collections (6 tools): Collections phone bundle, consent-gated alternate contacts/addresses, vehicle RC, caller ID.
• fraud (5 tools): Carrier SIM telemetry (age/swap/port), phone/email investigation, digital footprint.
• compliance (6 tools): Unified enforcement (SEBI/MCA/IBBI/CBI), UBO, PEP/sanctions, law enforcement dossiers.

Transports & Stack Launch

Documentation

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

Example Usage

# 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

• 📝 Issues
• 💬 Discussions
• 📧 Email Support
• 🌐 Documentation

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

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

Maintained by: Outris Technologies