Leximo AI Call Assistant — MCP Server

1# Leximo AI Call Assistant — MCP Server
2 
3[![npm version](https://img.shields.io/npm/v/leximo-ai-call-assistant-mcp-server)](https://www.npmjs.com/package/leximo-ai-call-assistant-mcp-server)
4[![Node >=18](https://img.shields.io/node/v/leximo-ai-call-assistant-mcp-server)](https://nodejs.org)
5[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
6[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
7 
8An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets you schedule AI phone calls and manage [Leximo](https://leximo.ai) assignments directly from Claude Desktop or Claude Code — no app switching needed.
9 
10---
11 
12## Quick Install
13 
14### Claude Code (one command)
15 
16```bash
17claude mcp add leximo -e LEXIMO_API_TOKEN=your-token -- npx -y leximo-ai-call-assistant-mcp-server
18```
19 
20Replace `your-token` with your API token from [concierge.leximo.ai/profile](https://concierge.leximo.ai/profile).
21 
22### Claude Code (plugin marketplace)
23 
24```
25/plugin marketplace add leximo-ai/leximo-ai-call-assistant-mcp-server
26```
27 
28Then install the plugin:
29 
30```
31/plugin install leximo-ai-call-assistant
32```
33 
34---
35 
36## Manual Setup
37 
38### 1. Get your API token
39 
401. Go to [concierge.leximo.ai](https://concierge.leximo.ai) and sign in
412. Open your [profile page](https://concierge.leximo.ai/profile)
423. Copy your JWT access token
43 
44### 2. Configure Claude Desktop
45 
46Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
47 
48```json
49{
50  "mcpServers": {
51    "leximo": {
52      "command": "npx",
53      "args": ["-y", "leximo-ai-call-assistant-mcp-server"],
54      "env": {
55        "LEXIMO_API_TOKEN": "your-token"
56      }
57    }
58  }
59}
60```
61 
62### 3. Configure Claude Code (manual)
63 
64Add to your Claude Code MCP settings:
65 
66```json
67{
68  "mcpServers": {
69    "leximo": {
70      "command": "npx",
71      "args": ["-y", "leximo-ai-call-assistant-mcp-server"],
72      "env": {
73        "LEXIMO_API_TOKEN": "your-token"
74      }
75    }
76  }
77}
78```
79 
80---
81 
82## Features
83 
84- **Assignments** — Create, list, view, and delete AI phone call assignments
85- **AI Agents** — Browse available calling agents and pick the right one
86- **Task Proposals** — Get AI-generated improvements for your call instructions
87- **Credits** — Check your credit balance and usage history
88- **Subscriptions** — View your plan, browse available plans, and subscribe
89- **Notifications** — View call completion events and system notifications
90 
91---
92 
93## Available Tools
94 
95| Tool | Description |
96|------|-------------|
97| `get_profile` | Get your user profile and account details |
98| `get_credits` | Check credit balance, usage history, and subscription summary |
99| `get_subscription` | View active subscription details |
100| `get_plans` | List available subscription plans with pricing |
101| `create_checkout_session` | Get a checkout URL to subscribe to a plan |
102| `list_agents` | List available AI calling agents |
103| `get_agent` | Get details of a specific agent |
104| `list_assignments` | List all your assignments (paginated) |
105| `get_assignment` | View a specific assignment with results and transcript |
106| `create_assignment` | Create a new phone call assignment |
107| `delete_assignment` | Delete an assignment |
108| `get_assignment_proposals` | Get AI suggestions to improve your task description |
109| `list_notifications` | Get call completion events and notifications |
110 
111---
112 
113## Example Prompts
114 
115Once configured, ask Claude things like:
116 
117- _"Show me my Leximo assignments"_
118- _"Create a call to +1234567890 to book a restaurant for 2 at 7pm Friday"_
119- _"How many credits do I have left?"_
120- _"What subscription plans are available?"_
121- _"Show me the transcript from my last call"_
122- _"What agents are available and which one is best for restaurant bookings?"_
123 
124---
125 
126## Development
127 
128```bash
129npm install
130npm run build      # Compile TypeScript
131npm start          # Run compiled server
132npm run dev        # Run with tsx (hot reload)
133```
134 
135### Test with MCP Inspector
136 
137```bash
138LEXIMO_API_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/index.js
139```
140 
141### Environment Variables
142 
143| Variable | Required | Description |
144|----------|----------|-------------|
145| `LEXIMO_API_TOKEN` | Yes | JWT token from [concierge.leximo.ai/profile](https://concierge.leximo.ai/profile) |
146 
147Copy `.env.example` to `.env` for local development.
148 
149---
150 
151## License
152 
153[MIT](LICENSE) © [Leximo](https://leximo.ai)
154