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

| 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