mcp-server

prosaichq/mcp-server

3.2

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Prosaic MCP Server allows seamless interaction with the Prosaic API through natural language, enabling integration with AI assistants like Claude Desktop and Perplexity AI.

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

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