Skip to main content
Neptune works with any AI tool that supports the Model Context Protocol (MCP). This guide covers how to connect using STDIO or HTTP transport.

Prerequisites

  • Python 3.13+ installed
  • uv package manager
Most MCP clients use STDIO transport, where the client spawns the MCP server as a subprocess and communicates via stdin/stdout.

The Command

Configuration Format

Most clients use a JSON configuration like this:
On Windows, you need to wrap the command with cmd /c because most MCP clients can’t directly execute uvx.

Where to Put This Configuration

Option 2: HTTP Transport

If your client doesn’t support STDIO, or you prefer HTTP, you can run the Neptune MCP as an HTTP server.

Start the Server

The server starts at http://localhost:8001/mcp by default.

Connect Your Client

Configure your MCP client to connect to:

Custom Port

To use a different port:
The HTTP server must be running before your AI client tries to connect. Consider running it in a separate terminal or as a background service.

Available Tools

Once connected, your AI assistant has access to these Neptune tools:

Troubleshooting

Make sure uv is installed and in your PATH:
If not found, reinstall uv and restart your terminal/shell.
Neptune MCP requires Python 3.13+. Check your version:
If needed, install Python 3.13+ from python.org.
Try running the command manually in your terminal to see error messages:
Press Ctrl+C to stop.
  1. Make sure the HTTP server is running before connecting
  2. Check if something else is using port 8001
  3. Try a different port with --port=9000
On Windows, always wrap with cmd /c:

Next Steps

Once connected, head to the Quickstart to authenticate and deploy your first app.