# Rapid Platform MCP Server

An MCP (Model Context Protocol) server that enables agentic LLMs to interact with the [Rapid Platform](https://rapidplatform.com) API.

## Tools

| Tool | Description |
|------|-------------|
| `get_lists` | Get all available lists (tables) |
| `get_list_views` | Get all views for a specific list |
| `get_list_schema` | Get the schema (fields/types) for a list |
| `get_item_schema` | Get the schema for a single item from a list |
| `get_all_items` | Get items from a list with OData filtering, selection, pagination |
| `get_item` | Get a specific item by ID |
| `create_item` | Create a new item in a list |
| `update_item` | Update an existing item |
| `create_webhook` | Create a webhook for list events |

## Setup

### Prerequisites

- Node.js 18+
- A Rapid Platform account with API access

### Install and Build

```bash
npm install
npm run build
```

### Configuration

Set these environment variables:

| Variable | Required | Description |
|----------|----------|-------------|
| `RAPID_ACCESS_TOKEN` | Yes | OAuth2 Bearer token for authentication |
| `RAPID_TENANT_ID` | Yes | Your Rapid Platform tenant ID |
| `RAPID_SITE_ID` | No | Your Rapid Platform site ID |
| `RAPID_BASE_URL` | No | API base URL (defaults to `https://api.rapidplatform.com`) |

### Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "rapid-platform": {
      "command": "node",
      "args": ["/path/to/rapid-platform-mcp-server/dist/index.js"],
      "env": {
        "RAPID_ACCESS_TOKEN": "your-token-here",
        "RAPID_TENANT_ID": "your-tenant-id",
        "RAPID_SITE_ID": "your-site-id"
      }
    }
  }
}
```

### Usage with Claude Code

```bash
claude mcp add rapid-platform -- node /path/to/rapid-platform-mcp-server/dist/index.js
```

Set the environment variables in your shell before launching Claude Code, or pass them inline.

## Development

```bash
npm run dev    # Watch mode - recompiles on changes
npm run build  # One-time build
npm start      # Run the server
```