mcp-fastn

Available as npm package: fastn Latest version: 0.1.0 Open source and actively maintained on GitHub

Updated
#npm

Fastn MCP Gateway

One hosted MCP endpoint for all your tools. Fastn Connect puts any number of MCP servers, app connectors and databases behind a single URL, adds per-user OAuth (each person brings their own account), governance (RBAC/ABAC, PII/PHI redaction, audit logging) and per-tool config, then serves it to Claude, ChatGPT, Cursor, Codex or any MCP client.

There is nothing to install or host. This repository holds no server code: it points to the gateway and its docs.

Using an older guide? https://mcp.live.fastn.ai/shttp, the pip install fastn-mcp-server package and its find_tools / execute_tool / flow tools belong to the retired v1 server. That endpoint no longer serves traffic. Use https://mcp.fastn.dev instead. The v1 code is kept on the v1 branch for reference only.

Quickstart

  1. Connect a tool. Sign in at connect.fastn.dev, open Tools, then Browse connectors to pick an app from the catalog or Add MCP server to paste any MCP server's URL. OAuth servers are detected and open a sign-in popup.
  2. Copy your gateway URL from Home. It exposes every enabled tool from every connected server, namespaced as <connector>__<tool> (for example slack__send_message).
  3. Add it to your client as a remote MCP server over Streamable HTTP. On first connect the client opens a browser tab where you sign in to Fastn Connect once; there is no token to paste.

Full guide: Quickstart.

Which URL to use

URL What it connects
https://mcp.fastn.dev Your org and workspace, taken from your sign-in or access key. On first connect you pick which tools the client gets.
https://mcp.fastn.dev/<org>, https://mcp.fastn.dev/<org>/<workspace> The same, with the org (or a named workspace in it) named explicitly. Home in Fastn Connect shows this form.
https://mcp.fastn.dev/fastn-workspace Only Fastn Workspace: your fastn workflows and the fastn platform tools. No tool picker; signing in is the consent. This is the URL the fastn dashboard hands out. /<org>/fastn-workspace pins the org.
https://mcp.fastn.dev/<org>/<workspace>/<app> A single app, with no tool picker.

A trailing /mcp is optional on every form. Details: Gateway API, headers, and access keys.

Connect a client

The examples use https://mcp.fastn.dev/your-company; replace it with your URL. Step-by-step setup for every supported client (Claude, Claude Code, ChatGPT, Cursor, VS Code, Codex, Antigravity, Devin, Cline, Lovable, Bolt, Zed) is in Connect clients.

Claude Code

claude mcp add --transport http fastn https://mcp.fastn.dev/your-company
claude mcp login fastn

Claude / ChatGPT: add a custom connector (Claude: Customize > Connectors > Add custom connector; ChatGPT: Plugins > Add > Add custom MCP server), paste the URL, leave authentication on OAuth, then Connect.

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "fastn": { "url": "https://mcp.fastn.dev/your-company" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "fastn": { "type": "http", "url": "https://mcp.fastn.dev/your-company" }
  }
}

Codex

codex mcp add fastn --url https://mcp.fastn.dev/your-company

Clients that cannot sign in: access keys

An admin creates an access key from Connect a client on Home or the Agents page. Send it as a bearer token:

claude mcp add --transport http fastn https://mcp.fastn.dev/your-company \
  --header "Authorization: Bearer ucl_<access-key>"

Headless and multi-tenant agents

One agent key can serve many tenants and end users. Pass the tenant and the user to act as on each client:

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "fastn": {
        "transport": "streamable_http",
        "url": "https://mcp.fastn.dev/your-company",
        "headers": {
            "Authorization": "Bearer ucl_<agent-key>",
            "X-Org-Id": "acme",
            "X-User-Id": "user@acme.com",
        },
    }
})

See Multi-tenant agents and Gateway API, headers, and access keys.

Docs

Topic Link
What is an MCP gateway? https://connect.fastn.dev/docs/what-is-an-mcp-gateway
Per-user OAuth https://connect.fastn.dev/docs/per-user-oauth
Connector auth modes https://connect.fastn.dev/docs/connector-auth-modes
Multi-tenancy and authentication https://connect.fastn.dev/docs/multi-tenancy-and-auth
Organizations, teams, and roles https://connect.fastn.dev/docs/organizations-and-teams
Governance: RBAC, redaction, per-tool config https://connect.fastn.dev/docs/governance
Tools and databases https://connect.fastn.dev/docs/tools-workflows-databases

The docs at connect.fastn.dev are the source of truth. If this README and the docs disagree, the docs win.

Support

Open an issue in this repository or reach us through fastn.ai.

License

MIT

Server Information
Authorfastnai
CategoryDevelopment

Features

NPM Package

Rate this server

0/5 stars

Related MCP servers