Prosaic MCP Server

MCP server for the Prosaic API. Enables Claude Desktop, Perplexity AI, and Cursor to interact with your Prosaic account directly through natural language.

Prerequisites

• Python 3.10+ (3.12 recommended)
• A Prosaic API key from beta.prosaic.works

---

Installation

1. Pull the Repository

git clone https://github.com/prosaichq/mcp-server.git
cd mcp-server

2. Build (Install Dependencies)

# Create virtual environment
python3 -m venv .venv

# Activate virtual environment
source .venv/bin/activate  # macOS/Linux
# or
.venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

3. Run (Test)

# Test the server runs correctly
PROSAIC_API_KEY=prsk_your_api_key python server.py

You should see: "Successfully loaded OpenAPI spec with X endpoints"

Press Ctrl+C to stop.

---

Configuration

Get Your Prosaic API Key

1. Log in to beta.prosaic.works
2. Go to Settings → Users → API Keys
3. Click "Generate New API Key"
4. Copy the key (starts with prsk_)

---

Configure Claude Desktop

Configuration File:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this:

{
    "mcpServers": {
        "prosaic-mcp": {
            "command": "/FULL/PATH/TO/.venv/bin/python",
            "args": [
                "/FULL/PATH/TO/server.py"
            ],
            "env": {
                "PROSAIC_API_KEY": "prsk_your_api_key_here"
            }
        }
    }
}

Replace:

• /FULL/PATH/TO/.venv/bin/python with your actual Python path
• /FULL/PATH/TO/server.py with your actual server.py path
• prsk_your_api_key_here with your Prosaic API key

To find your paths:

cd /path/to/mcp-server
source .venv/bin/activate
which python  # Copy this path
pwd           # Use this + /server.py

Activate: Quit Claude Desktop (Cmd+Q) and restart.

---

Configure Perplexity AI

Configuration File:

• macOS: ~/Library/Application Support/Perplexity/mcp_config.json
• Windows: %APPDATA%\Perplexity\mcp_config.json

Add this:

{
    "mcpServers": {
        "prosaic-mcp": {
            "command": "/FULL/PATH/TO/.venv/bin/python",
            "args": [
                "/FULL/PATH/TO/server.py"
            ],
            "env": {
                "PROSAIC_API_KEY": "prsk_your_api_key_here"
            }
        }
    }
}

.

Replace the same paths and API key as above.

Activate: Restart Perplexity AI.

Reference: Perplexity MCP Documentation

---

Open AI desktop / web

Currently this implementation is not support on OpenAI

---

Usage

Once configured, ask your AI assistant:

What Prosaic entities do I have?

You should see a list of your Prosaic entities.

---

Troubleshooting

"Tools not showing"

• Restart the application completely (don't just reload)
• Check the config file for JSON syntax errors
• Verify paths are correct absolute paths

"API key errors"

• Verify your API key starts with prsk_
• Check your API key is valid at beta.prosaic.works
• Ensure no extra spaces in the config

---

How It Works

1. Fetches Prosaic OpenAPI specification on startup
2. Converts all API endpoints to MCP tools automatically
3. Authenticates with your API key
4. Handles requests from AI assistants
5. Returns Prosaic data in a format AI can understand

---

Support

• Prosaic Help: beta.prosaic.works
• MCP Protocol: modelcontextprotocol.io
• FastMCP Docs: gofastmcp.com