The Fastn server is a powerful, scalable platform that enables dynamic tool registration and execution based on API definitions. It seamlessly integrates with services like Claude.ai and Cursor.ai, providing a unified server solution for a wide range of tasks.
The easiest way to install the Fastn server is using pip:
pip install fastn-mcp-server
To find the exact path of the installed command:
which fastn-mcp-server
where fastn-mcp-server
# Clone repository and navigate to directory git clone <your-repo-url> && cd fastn-server # macOS/Linux: Install UV, create virtual environment, and install dependencies curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e . # Windows (PowerShell): Install UV, create a virtual environment, and install dependencies powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e . # Install dependencies directly uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"
The server supports two authentication methods:
Authentication Method 1: API Key# Package installation fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID # Manual installation uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_IDAuthentication Method 2: Tenant-based
# Package installation fastn-mcp-server --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKEN # Manual installation uv run fastn-server.py --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKENIntegration with AI Assistants
Open the Claude configuration file:
notepad "%APPDATA%\Claude\claude_desktop_config.json"
or code "%APPDATA%\Claude\claude_desktop_config.json"
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Add the appropriate configuration:
{ "mcpServers": { "fastn": { "command": "/path/to/fastn-mcp-server", "args": [ "--api_key", "YOUR_API_KEY", "--space_id", "YOUR_WORKSPACE_ID" ] } } }
Or with tenant authentication:
{ "mcpServers": { "fastn": { "command": "/path/to/fastn-mcp-server", "args": [ "--space_id", "YOUR_WORKSPACE_ID", "--tenant_id", "YOUR_TENANT_ID", "--auth_token", "YOUR_AUTH_TOKEN" ] } } }Using Manual Installation
API Key authentication:
{ "mcpServers": { "fastn": { "command": "/path/to/your/uv", "args": [ "--directory", "/path/to/your/fastn-server", "run", "fastn-server.py", "--api_key", "YOUR_API_KEY", "--space_id", "YOUR_WORKSPACE_ID" ] } } }
Tenant authentication:
{ "mcpServers": { "fastn": { "command": "/path/to/your/uv", "args": [ "--directory", "/path/to/your/fastn-server", "run", "fastn-server.py", "--space_id", "YOUR_WORKSPACE_ID", "--tenant_id", "YOUR_TENANT_ID", "--auth_token", "YOUR_AUTH_TOKEN" ] } } }
API Key authentication:
/path/to/fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID
Tenant authentication:
/path/to/fastn-mcp-server --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKEN
Using Manual Installation
API Key authentication:
/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID
Tenant authentication:
/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --space_id YOUR_WORKSPACE_ID --tenant_id YOUR_TENANT_ID --auth_token YOUR_AUTH_TOKEN
If you encounter an error like this during installation:
ValueError: Unable to determine which files to ship inside the wheel using the following heuristics:
The most likely cause of this is that there is no directory that matches the name of your project (fastn).
Quick Fix:
pyproject.toml
has the wheel configuration:[tool.hatch.build.targets.wheel] packages = ["."]
uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"
This project is licensed under the terms included in the LICENSE file.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4