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)

Build the Docker image:

npm run docker:build

Run the server:

LITHIC_API_KEY=your_key_here npm run docker:run

Manual Setup

Install dependencies:

npm install

Build the TypeScript code:

npm run build

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.

Lithic