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.