Lithic

🚀 Lithic MCP Server (TypeScript)

A Model Context Protocol (MCP) server for the Lithic API implemented in TypeScript, providing read-only access to Lithic's banking and card services.

✨ Features

• A 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

📚 Documentation

MCP Configuration

Add the following 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: Retrieve a specific Lithic resource by ID/token.
• list_resources: List resources of a specified type.

Environment Variables

Supported Resource Types

• Cards
• Accounts
• Financial Accounts
• Transactions
• Events
• Balances
• Disputes
• External Bank Accounts
• Reports
• Callbacks
• Account Holders

Development

For development, you can use watch mode:

npm run dev

This will automatically rebuild and restart the server when you change the source code.