Skip to main content
Glama
enesjakozh

Fastn Server

Official
by fastnai
GitHub
Python
MIT License
11
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Login to your Fastn account

  2. Go to "Connectors" from the left sidebar

  3. Activate the service(s) you want to use by clicking on activate.

  4. Go to "Settings" from the left sidebar

  5. Click on "Generate API Key" and save it somewhere locally (e.g., in a notepad)

  6. Click on the copy button that exists on the top bar (left side of your profile)

  7. Copy your Workspace ID and save it as well

  8. 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

  • Python 3.10 or higher

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)

  1. Find the path to your installed fastn-server:

    • On macOS/Linux: which fastn-server

    • On Windows: where fastn-server

  2. Configure your AI assistant with the path from step 1.

For Manual Installation (Option 2)

Integration with Claude On Mac OS

  1. Open the Claude configuration:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

  1. 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

  1. Open Cursor settings

  2. Click on "MCP" in the settings menu

  3. Click on "Add New"

  4. Add a name for your server (e.g., "fastn")

  5. Select "Command" as the type

  6. 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

  1. 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

  2. Add the appropriate configuration JSON based on your installation method.

For Cursor

  1. Open Cursor settings

  2. Click on "MCP" in the settings menu

  3. Click on "Add New"

  4. Add a name for your server (e.g., "fastn")

  5. Select "Command" as the type

  6. 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:

  1. Make sure pyproject.toml has the wheel configuration:

[tool.hatch.build.targets.wheel] packages = ["."]

  1. Then install dependencies:

uv pip install "httpx>=0.28.1" "mcp[cli]>=1.2.0"

  1. 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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that enables dynamic tool registration and execution based on API definitions, providing seamless integration with services like Claude.ai and Cursor.ai.

  1. Getting Started
    1. Package Installation (Recommended)
  2. Features
    1. Step-by-Step Setup Guide
      1. Step 1: Fastn Setup
      2. Step 2: Server Setup
    2. Prerequisites
      1. Quick Start
        1. macOS
        2. Windows
        3. Step 3: Integration with AI Assistants
        4. Detailed Integration Instructions
        5. Troubleshooting
      2. Logging
        1. Support
          1. License

            Related MCP Servers

            • Agent Construct

              ai-mcp-garage
              -
              security
              A
              license
              -
              quality
              An MCP server implementation that standardizes how AI applications access tools and context, providing a central hub that manages tool discovery, execution, and context management with a simplified configuration system.
              Last updated -
              13
              MIT License

            • MCP Manager

              samihalawa
              -
              security
              F
              license
              -
              quality
              A flexible server that enables communication between AI models and tools, supporting multiple MCP servers and compatible with Claude, MCP Dockmaster, and other MCP clients.
              Last updated -
              23
              1

            • Routine

              mquan
              A
              security
              F
              license
              A
              quality
              An MCP server that allows users to create custom tools on the fly by stitching together actions from multiple MCP tools into reusable routines.
              Last updated -
              4
              0
              1

            • Postman MCP Generator

              A
              security
              F
              license
              A
              quality
              An MCP-compatible server that exposes automated API tools to MCP clients like Claude Desktop or Postman, allowing AI assistants to interact with your selected APIs.

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/fastnai/mcp-fastn'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server