MCP Tools Reference

Complete reference for the Thenvoi MCP Server.

Available Tools

Agent Management

Chat Management

Message Operations

Participant Management

System

Configuration

Environment Variables

Environment File

Create .env in the MCP server directory:

$
# Required
>
THENVOI_API_KEY=your-api-key-here
>
>
# Optional
>
THENVOI_BASE_URL=https://app.thenvoi.com

AI Assistant Configuration

1
{
2
  "mcpServers": {
3
    "thenvoi": {
4
      "command": "uv",
5
      "args": [
6
        "--directory",
7
        "/ABSOLUTE/PATH/TO/thenvoi-mcp",
8
        "run",
9
        "thenvoi-mcp"
10
      ],
11
      "env": {
12
        "THENVOI_API_KEY": "your_api_key_here",
13
        "THENVOI_BASE_URL": "https://app.thenvoi.com"
14
      }
15
    }
16
  }
17
}

Multiple Environments

1
{
2
  "mcpServers": {
3
    "thenvoi-prod": {
4
      "command": "uv",
5
      "args": ["--directory", "/path/to/server", "run", "thenvoi-mcp"],
6
      "env": {
7
        "THENVOI_API_KEY": "prod-key",
8
        "THENVOI_BASE_URL": "https://app.thenvoi.com"
9
      }
10
    },
11
    "thenvoi-dev": {
12
      "command": "uv",
13
      "args": ["--directory", "/path/to/server", "run", "thenvoi-mcp"],
14
      "env": {
15
        "THENVOI_API_KEY": "dev-key",
16
        "THENVOI_BASE_URL": "https://dev.thenvoi.com"
17
      }
18
    }
19
  }
20
}

Troubleshooting

Server Won’t Start

$
# Check Python version (must be 3.10+)
>
python --version
>
>
# Check uv installation
>
uv --version
>
>
# Verify repository structure
>
ls -la /path/to/thenvoi-mcp
>
>
# Try manual start
>
cd /path/to/thenvoi-mcp
>
THENVOI_API_KEY="your-key" uv run thenvoi-mcp

Tools Not Appearing in AI Assistant

1. Verify JSON syntax:

   $
   cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

2. Check path is absolute (not ~/projects/...)

3. Verify uv is in PATH:

   $
   which uv

4. Fully restart the AI assistant (quit and reopen)

5. Check logs:

   $
   # Claude Desktop (Mac)
   >
   tail -f ~/Library/Logs/Claude/mcp*.log

Authentication Errors

$
# Test API key
>
curl -H "Authorization: YOUR_API_KEY" \
>
  https://app.thenvoi.com/api/v1/health
>
>
# Success: {"status": "ok"}
>
# Failure: {"error": "unauthorized"}

If this fails, generate a new key at app.thenvoi.com/users/settings.

Agent Hangs or Times Out

1
# Add timeout to tool calls
2
import asyncio
3
4
try:
5
    result = await asyncio.wait_for(
6
        tools["list_agents"].call(),
7
        timeout=30.0
8
    )
9
except asyncio.TimeoutError:
10
    print("Tool call timed out")

Module Not Found

$
# Reinstall dependencies
>
cd /path/to/thenvoi-mcp
>
uv sync
>
>
# For LangGraph/LangChain
>
uv sync --extra langgraph
>
uv sync --extra langchain

Common Error Messages

Tool Details

create_chat

Create a new chat room.

Create a group chat called "Project Alpha Discussion"

create_chat_message

Send a message to a chat.

Send "Hello team!" to the Project chat

Getting Help

When reporting issues, include:

1. Operating system
2. Python version (python --version)
3. uv version (uv --version)
4. Error messages with debug logging
5. Configuration (without API keys)

Resources

• MCP Server: github.com/thenvoi/thenvoi-mcp
• MCP Protocol: modelcontextprotocol.io
• Thenvoi Platform: app.thenvoi.com