Lithic MCP Server (TypeScript)

A TypeScript implementation of a Model Context Protocol (MCP) server for Lithic API that provides read-only access to Lithic banking and card services.

Features

• Modern TypeScript implementation using the MCP SDK
• Read-only access to all Lithic API endpoints
• Type-safe tools for accessing Lithic resources
• Docker support
• Improved error handling and validation

Quick Start

Using Docker (Recommended)

1. Build the Docker image:

npm run docker:build

2. Run the server:

LITHIC_API_KEY=your_key_here npm run docker:run

Manual Setup

1. Install dependencies:

npm install

2. Build the TypeScript code:

npm run build

3. Start the server:

LITHIC_API_KEY=your_key_here npm start

MCP Configuration

Add this to your .cursor/mcp.json or Claude Desktop configuration:

{
  "lithic": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-e", "LITHIC_API_KEY",
      "-e", "LITHIC_API_BASE_URL",
      "mcp/lithic"
    ],
    "env": {
      "LITHIC_API_KEY": "your_lithic_api_key_here",
      "LITHIC_API_BASE_URL": "https://api.lithic.com/v1"
    }
  }
}

Available Tools

This MCP server provides the following tools:

• get_resource: Fetch a specific Lithic resource by ID/token
• list_resources: List resources of a given type

Environment Variables

• LITHIC_API_KEY - Your Lithic API key (required)
• LITHIC_API_BASE_URL - Lithic API base URL (default: https://sandbox.lithic.com/v1)

Supported Resource Types

• card
• account
• financial_account
• transaction
• event
• balance
• dispute
• external_bank_account
• report
• webhook
• account_holder

Development

For development, you can use the watch mode:

npm run dev

This will automatically rebuild and restart the server when you make changes to the source code.