# 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:
```bash
npm run docker:build
```

2. Run the server:
```bash
LITHIC_API_KEY=your_key_here npm run docker:run
```

### Manual Setup

1. Install dependencies:
```bash
npm install
```

2. Build the TypeScript code:
```bash
npm run build
```

3. Start the server:
```bash
LITHIC_API_KEY=your_key_here npm start
```

## MCP Configuration

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

```json
{
  "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:

```bash
npm run dev
```

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