Federated Directory MCP
A Model Context Protocol (MCP) server that integrates Claude with the Federated Directory API, allowing for contact searches by name or email address.
Features
Search contacts by name
Search contacts by email address
Comprehensive API request/response logging
Automatic query type detection
Error handling and validation
Prerequisites
Node.js (v18 or higher)
A Federated Directory API key
Installation
Clone the repository:
Install dependencies:
Copy the environment variables template:
Configure your environment variables in
.env:
Usage
Start the MCP server:
The server will start and wait for requests from Claude.
Example interactions:
Search by name:
Input: "John Smith"Search by email:
Input: "john@example.com"
API Response Format
The server returns results in the following format:
Logging
The server logs all API interactions, including:
Request method, URL, headers, and body
Response status, headers, and body
Search parsing and processing details
Environment Variables
Variable | Description | Required | Default |
FEDERATED_DIRECTORY_API_KEY | Your API key for Federated Directory | Yes | - |
PORT | Server port number | No | 3000 |
LOG_LEVEL | Logging verbosity | No | info |
Error Handling
The server handles various error cases:
Missing API key
Invalid search queries
API request failures
Network issues
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables contact searches within the Federated Directory system by name or email address. Provides comprehensive logging and automatic query type detection for seamless contact lookup integration.