# Reltio MCP Server

A Python-based Model Context Protocol (MCP) server that connects AI assistants to Reltio data through a set of structured, reusable tools.

The server exposes Reltio entity search, entity details, record counts, and relationship retrieval as MCP tools, allowing an MCP-compatible AI client to interact with Reltio data through natural-language requests.

---

## 🚀 Overview

This project demonstrates how to build an MCP server that acts as a bridge between an AI assistant and a Reltio data environment.

Instead of requiring the AI assistant to directly understand and manage Reltio API requests, the MCP server exposes high-level tools such as:

- Search contacts
- Search organizations
- Search locations
- Search stations
- Search voyagers
- Search any supported entity type
- Retrieve complete entity details
- Count records by entity type
- Retrieve entity relationships

The server communicates with Reltio using its REST APIs and exposes the functionality through the Model Context Protocol (MCP).

---

## 🏗️ Architecture

                 AI Assistant / MCP Client
                           │
                           │ MCP / stdio
                           ▼
                  ┌──────────────────┐
                  │   Reltio MCP     │
                  │      Server      │
                  │     (Python)     │
                  └────────┬─────────┘
                           │
                           │ REST API
                           ▼
                  ┌──────────────────┐
                  │      Reltio      │
                  │   Data Platform  │
                  └──────────────────┘

Natural Language Request
          ↓
      MCP Client
          ↓
     MCP Tool Call
          ↓
     Python Server
          ↓
      Reltio REST API
          ↓
    Response Processing
          ↓
     Structured JSON
          ↓
      MCP Client


📚 Key Concepts Demonstrated

This project demonstrates practical experience with:

Model Context Protocol (MCP)
AI-to-data integration
API integration
REST APIs
Reltio MDM
Asynchronous Python
HTTP clients
Environment-based configuration
JSON data transformation
Tool-based AI interaction
Entity search and relationship traversal

<img width="1913" height="910" alt="image" src="https://github.com/user-attachments/assets/e47a3200-1b3d-43b5-ad37-0272e9281202" />
<img width="1564" height="1073" alt="image" src="https://github.com/user-attachments/assets/d46957c4-38c6-4deb-92bb-9079e51763ad" />
<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/2191ee39-8b5e-47b7-83bc-b981f259eed2" />
<img width="1611" height="974" alt="image" src="https://github.com/user-attachments/assets/4080d66b-ee86-4149-87d0-4835c4231157" />