Fastn Server
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. With its robust architecture, Fastn delivers exceptional performance and flexibility for real-time, API-driven operations.
Getting Started
Package Installation (Recommended)
The easiest way to install the Fastn server is using pip:
pip install fastn-mcp-server
After installation, you can run the server with:
fastn-mcp-server --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
When using the package installation, your configuration for AI assistants will look like:
macOS/Linux:
{
"mcpServers": {
"fastn": {
"command": "/path/to/fastn-mcp-server",
"args": [
"--api_key",
"YOUR_API_KEY",
"--space_id",
"YOUR_WORKSPACE_ID"
]
}
}
}
Windows:
{
"mcpServers": {
"fastn": {
"command": "C:\\path\\to\\fastn-mcp-server.exe",
"args": [
"--api_key",
"YOUR_API_KEY",
"--space_id",
"YOUR_WORKSPACE_ID"
]
}
}
}
To find the exact path of the installed fastn-server command:
- On macOS/Linux:
which fastn-server - On Windows:
where fastn-server
Features
- Integrated platform support - Use services like Slack, Notion, HubSpot, and many more through the Fastn server after completing the simple setup
- Logging support - Comprehensive logging system
- Error handling - Robust error management for various scenarios
Step-by-Step Setup Guide
Step 1: Fastn Setup
- Login to your Fastn account
- Go to "Connectors" from the left sidebar
- Activate the service(s) you want to use by clicking on activate.
- Go to "Settings" from the left sidebar
- Click on "Generate API Key" and save it somewhere locally (e.g., in a notepad)
- Click on the copy button that exists on the top bar (left side of your profile)
- Copy your Workspace ID and save it as well
- All setup from Fastn is now complete
Step 2: Server Setup
Option 1: Use Package Installation (Recommended)
See the "Package Installation" section above.
Option 2: Manual Setup
Prerequisites
Quick Start
macOS
# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server
# Install UV, create virtual environment, and install dependencies in one go
curl -LsSf https://astral.sh/uv/install.sh | sh && uv venv && source .venv/bin/activate && uv pip install -e .
# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
Windows
# Clone repository and navigate to directory
git clone <your-repo-url> && cd fastn-server
# Install UV, create a virtual environment, and install dependencies
# Option 1: Install UV using pip
python -m pip install uv
# Make sure to copy the installation path and add it to your Windows environment variables.
# Option 2: Install UV using PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" && uv venv && .venv\Scripts\activate && uv pip install -e .
# Run server (specify platform with --platform flag)
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
Step 3: Integration with AI Assistants
For Package Installation (Option 1)
- Find the path to your installed fastn-server:
- On macOS/Linux:
which fastn-server - On Windows:
where fastn-server
- Configure your AI assistant with the path from step 1.
For Manual Installation (Option 2)
Integration with Claude On Mac OS
- Open the Claude configuration:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Add the following configuration (replace placeholders with your actual values):
{
"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"
]
}
}
}
Integration with Cursor
- Open Cursor settings
- Click on "MCP" in the settings menu
- Click on "Add New"
- Add a name for your server (e.g., "fastn")
- Select "Command" as the type
- Add the following command (replace placeholders with your actual values):
/path/to/your/uv --directory /path/to/your/fastn-server run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_WORKSPACE_ID
Detailed Integration Instructions
For Claude
- Open the Claude configuration file:
- Windows:
notepad "%APPDATA%\Claude\claude_desktop_config.json" or code "%APPDATA%\Claude\claude_desktop_config.json" - Mac:
open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json or code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Add the appropriate configuration JSON based on your installation method.
For Cursor
- Open Cursor settings
- Click on "MCP" in the settings menu
- Click on "Add New"
- Add a name for your server (e.g., "fastn")
- Select "Command" as the type
- Use the appropriate configuration based on your installation method
Troubleshooting
Package Structure Error
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:
- Make sure
pyproject.toml has the wheel configuration:
[tool.hatch.build.targets.wheel]
packages = ["."]
- Then install dependencies:
uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"
- Run the server:
uv run fastn-server.py --api_key YOUR_API_KEY --space_id YOUR_SPACE_ID
Logging
Logs are output with timestamp, level, and message in the following format:
%(asctime)s - %(levelname)s - %(message)s
Support
For questions, issues, or feature requests, please visit:
License
This project is licensed under the terms included in the LICENSE file.