Outris Identity

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

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

# 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