🚀 The fast, Pythonic way to build MCP servers and clients.
docs: rename Horizon to FastMCP Gateway in current docs (#5653)
Eddiea9dabc4dda36
diff --git a/README.md b/README.mdindex ed16fd664..436e1a9d3 100644--- a/README.md+++ b/README.md@@ -82,15 +82,17 @@ FastMCP has three pillars:Ready to build? Start with the [installation guide](https://gofastmcp.com/getting-started/installation) or jump straight to the [quickstart](https://gofastmcp.com/getting-started/quickstart).-## Scale MCP with Horizon+<a id="scale-mcp-with-horizon"></a>-FastMCP handles the MCP application layer. **[Prefect Horizon](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_body)** is the enterprise MCP gateway for scaling servers and tools across teams, with centralized governance over how they are deployed, discovered, secured, and used.+## Scale MCP with FastMCP Gateway-FastMCP and Horizon are built by the same team at [Prefect](https://www.prefect.io/).+FastMCP handles the MCP application layer. **[FastMCP Gateway](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_body)** is the enterprise MCP gateway for scaling servers and tools across teams, with centralized governance over how they are deployed, discovered, secured, and used.++FastMCP and FastMCP Gateway are built by the same team at [Prefect](https://www.prefect.io/).Deploy FastMCP servers from GitHub with branch previews and instant rollback. Create a private registry of every MCP your company uses. Secure access with SSO and tool-level RBAC. Get audit logs, observability, and governance across your MCP stack. Remix approved tools into purpose-built endpoints for teams and agents.-Start with FastMCP. [Scale with Horizon →](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_cta)+Start with FastMCP. [Scale with FastMCP Gateway →](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_cta)## Installationdiff --git a/docs/cli/overview.mdx b/docs/cli/overview.mdxindex 53f39f2ec..ab8de05f6 100644--- a/docs/cli/overview.mdx+++ b/docs/cli/overview.mdx@@ -28,9 +28,9 @@ fastmcp --help| [`generate-cli`](/cli/generate-cli) | Scaffold a standalone typed CLI from a server's tool schemas || [`project prepare`](/cli/running#pre-building-environments) | Pre-install dependencies into a reusable uv project || [`auth cimd`](/cli/auth) | Create and validate CIMD documents for OAuth |-| `login` | Sign in to Prefect Horizon with a browser device flow |-| `whoami` | Show the current Horizon account |-| `logout` | Revoke the current Horizon key and remove the local credential |+| `login` | Sign in to FastMCP Gateway with a browser device flow |+| `whoami` | Show the current FastMCP Gateway account |+| `logout` | Revoke the current FastMCP Gateway key and remove the local credential || `version` | Print version info (`--copy` to copy to clipboard) |## Server Targets@@ -84,9 +84,11 @@ Run [`fastmcp discover`](/cli/client#discovering-configured-servers) to see what## Authentication-### Prefect Horizon Account+<a id="prefect-horizon-account" />-Use the top-level account commands to manage the credential for Prefect Horizon.+### FastMCP Gateway Account++Use the top-level account commands to manage the credential for FastMCP Gateway.```bashfastmcp login@@ -100,9 +102,9 @@ It opens a browser when the terminal supports it.If the browser does not open, use the shown URL and code on another device.To switch accounts, run `fastmcp logout` before you run `fastmcp login` again.-Login stores only the personal Horizon API key.+Login stores only the personal FastMCP Gateway API key.It does not select or store a deployment organization.-`fastmcp whoami` gets the current user from Horizon.+`fastmcp whoami` gets the current user from FastMCP Gateway.`fastmcp logout` attempts to revoke the stored key and always removes its local credential.Set `HORIZON_API_KEY` to use an environment credential instead.diff --git a/docs/deployment/prefect-horizon.mdx b/docs/deployment/fastmcp-gateway.mdxsimilarity index 54%rename from docs/deployment/prefect-horizon.mdxrename to docs/deployment/fastmcp-gateway.mdxindex 9ff6c5356..ed67a6048 100644--- a/docs/deployment/prefect-horizon.mdx+++ b/docs/deployment/fastmcp-gateway.mdx@@ -1,21 +1,22 @@----title: Prefect Horizon-sidebarTitle: Prefect Horizon+title: FastMCP Gateway+sidebarTitle: FastMCP Gatewaydescription: The MCP platform from the FastMCP teamicon: cloud----[Prefect Horizon](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_horizon&utm_content=guide_intro) is a platform for deploying and managing MCP servers. Built by the FastMCP team at [Prefect](https://www.prefect.io), Horizon provides managed hosting, authentication, access control, and a registry of MCP capabilities.+[FastMCP Gateway](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_horizon&utm_content=guide_intro), formerly Horizon, is a platform for deploying and managing MCP servers.+Built by the FastMCP team at [Prefect](https://www.prefect.io), FastMCP Gateway provides managed hosting, authentication, access control, and a registry of MCP capabilities.-Horizon includes a **free personal tier for FastMCP users**, making it the fastest way to get a secure, production-ready server URL with built-in OAuth authentication.+FastMCP Gateway includes a **free personal tier for FastMCP users**, making it the fastest way to get a secure, production-ready server URL with built-in OAuth authentication.<Info>-Horizon is free for personal projects. Enterprise governance features are available for teams deploying to thousands of users.+FastMCP Gateway is free for personal projects. Enterprise governance features are available for teams deploying to thousands of users.</Info>## FastMCP CLI Account-Sign in to Horizon from the FastMCP CLI with the device authorization flow.+Sign in to FastMCP Gateway from the FastMCP CLI with the device authorization flow.```bashfastmcp login@@ -25,7 +26,7 @@ The command uses an environment key or a valid stored key when one is available.When login needs a new key, it shows a verification URL and code before it opens the browser.If the browser cannot open, visit the shown URL and enter the code.To switch accounts, run `fastmcp logout` before you run `fastmcp login` again.-New users can register and create their first Horizon organization in the browser.+New users can register and create their first FastMCP Gateway organization in the browser.Check the active account after login.@@ -48,26 +49,28 @@ Remove the variable from the environment to sign out.## The Platform-Horizon is organized into four integrated pillars:+FastMCP Gateway provides four capabilities:- **Deploy**: Managed hosting with CI/CD, scaling, monitoring, and rollbacks. Push code and get a live, governed endpoint in 60 seconds.- **Registry**: A central catalog of MCP servers across your organization—first-party, third-party, and curated remix servers composed from multiple sources.- **Gateway**: Role-based access control, authentication, and audit logs. Define what agents can see and do at the tool level.- **Agents**: A permissioned chat interface for interacting with any MCP server or curated combination of servers.-This guide focuses on **Horizon Deploy**, the managed hosting layer that gives you the fastest path from a FastMCP server to a production URL.+This guide focuses on **managed hosting**, the deployment capability that gives you the fastest path from a FastMCP server to a production URL.## Prerequisites-To use Horizon, you'll need a [GitHub](https://github.com) account and a GitHub repo containing a FastMCP server. If you don't have one yet, Horizon can create a starter repo for you during onboarding.+To use FastMCP Gateway, you'll need a [GitHub](https://github.com) account and a GitHub repo containing a FastMCP server.+If you don't have one yet, FastMCP Gateway can create a starter repo for you during onboarding.Your repo can be public or private, but must include at least a Python file containing a FastMCP server instance.<Tip>-To verify your file is compatible with Horizon, run `fastmcp inspect <file.py:server_object>` to see what Horizon will see when it runs your server.+Run `fastmcp inspect <file.py:server_object>` to verify that your server loads and list its tools, resources, prompts, and metadata.</Tip>-If you have a `requirements.txt` or `pyproject.toml` in the repo, Horizon will automatically detect your server's dependencies and install them. Your file *can* have an `if __name__ == "__main__"` block, but it will be ignored by Horizon.+If you have a `requirements.txt` or `pyproject.toml` in the repo, FastMCP Gateway will automatically detect your server's dependencies and install them.+Your file *can* have an `if __name__ == "__main__"` block, but FastMCP Gateway will ignore it.For example, a minimal server file might look like:@@ -83,33 +86,33 @@ def hello(name: str) -> str:## Getting Started-There are just three steps to deploying a server to Horizon:+There are just three steps to deploying a server to FastMCP Gateway:### Step 1: Select a Repository-Visit [horizon.prefect.io](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) and sign in with your GitHub account. Connect your GitHub account to grant Horizon access to your repositories, then select the repo you want to deploy.+Visit [horizon.prefect.io](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) and sign in with your GitHub account. Connect your GitHub account to grant FastMCP Gateway access to your repositories, then select the repo you want to deploy.-<img src="/assets/images/horizon/select-repo.png" alt="Horizon repository selection" />+<img src="/assets/images/horizon/select-repo.png" alt="FastMCP Gateway repository selection" />### Step 2: Configure Your Server-Next, you'll configure how Horizon should build and deploy your server.+Next, you'll configure how FastMCP Gateway should build and deploy your server.-<img src="/assets/images/horizon/configure-server.png" alt="Horizon server configuration" />+<img src="/assets/images/horizon/configure-server.png" alt="FastMCP Gateway server configuration" />The configuration screen lets you specify:- **Server name**: A unique name for your server. This determines your server's URL.- **Description**: A brief description of what your server does.- **Entrypoint**: The Python file containing your FastMCP server (e.g., `main.py`). This field has the same syntax as the `fastmcp run` command—use `main.py:mcp` to specify a specific object in the file.-- **Authentication**: When enabled, only authenticated users in your organization can connect. Horizon handles all the OAuth complexity for you.+- **Authentication**: When enabled, only authenticated users in your organization can connect. FastMCP Gateway handles OAuth authentication for you.-Horizon will automatically detect your server's Python dependencies from either a `requirements.txt` or `pyproject.toml` file.+FastMCP Gateway will automatically detect your server's Python dependencies from either a `requirements.txt` or `pyproject.toml` file.### Step 3: Deploy and Connect-Click **Deploy Server** and Horizon will clone your repository, build your server, and deploy it to a unique URL—typically in under 60 seconds.+Click **Deploy Server** and FastMCP Gateway will clone your repository, build your server, and deploy it to a unique URL, typically in under 60 seconds.-<img src="/assets/images/horizon/deployment-live.png" alt="Horizon deployment view showing live server" />+<img src="/assets/images/horizon/deployment-live.png" alt="FastMCP Gateway deployment view showing live server" />Once deployed, your server is accessible at a URL like:@@ -117,11 +120,11 @@ Once deployed, your server is accessible at a URL like:https://your-server-name.fastmcp.app/mcp```-Horizon monitors your repo and redeploys automatically whenever you push to `main`. It also builds preview deployments for every PR, so you can test changes before they go live.+FastMCP Gateway monitors your repo and redeploys automatically whenever you push to `main`. It also builds preview deployments for every PR, so you can test changes before they go live.## Testing Your Server-Horizon provides two ways to verify your server is working before connecting external clients.+FastMCP Gateway provides two ways to verify your server is working before connecting external clients.### Inspector@@ -131,23 +134,25 @@ The Inspector gives you a structured view of everything your server exposes—toFor quick end-to-end testing, ChatMCP lets you interact with your server conversationally. It uses a fast model optimized for rapid iteration—you can verify the server works, test tool calls in context, and confirm the overall behavior before sharing it with others.-<img src="/assets/images/horizon/chat.png" alt="Horizon ChatMCP interface" />+<img src="/assets/images/horizon/chat.png" alt="FastMCP Gateway ChatMCP interface" />ChatMCP is designed for testing, not as a daily work environment. Once you've confirmed your server works, you can copy connection snippets for Claude Desktop, Cursor, Claude Code, and other MCP clients—or use the FastMCP client library to connect programmatically.-## Horizon Agents+<a id="horizon-agents" />-Beyond testing individual servers, Horizon lets you create **Agents**—chat interfaces backed by one or more MCP servers. While ChatMCP tests a single server, Agents let you compose capabilities from multiple servers into a unified experience.+## Agents-<img src="/assets/images/horizon/agent-detail.png" alt="Horizon Agent configuration" />+Beyond testing individual servers, FastMCP Gateway lets you create **Agents**, chat interfaces backed by one or more MCP servers. While ChatMCP tests a single server, Agents let you compose capabilities from multiple servers into a unified experience.++<img src="/assets/images/horizon/agent-detail.png" alt="FastMCP Gateway Agent configuration" />To create an agent:1. Navigate to **Agents** in the sidebar2. Click **Create Agent** and give it a name and description-3. Add MCP servers to the agent—these can be servers you've deployed to Horizon or external servers in the registry+3. Add MCP servers to the agent—these can be servers you've deployed to FastMCP Gateway or external servers in the registry-Once configured, you can chat with your agent directly in Horizon:+Once configured, you can chat with your agent directly in FastMCP Gateway:-<img src="/assets/images/horizon/agent-chat.png" alt="Chatting with a Horizon Agent" />+<img src="/assets/images/horizon/agent-chat.png" alt="Chatting with an Agent in FastMCP Gateway" />Agents are useful for creating purpose-built interfaces that combine tools from different servers. For example, you might create an agent that has access to both your company's internal data server and a general-purpose utilities server.diff --git a/docs/deployment/http.mdx b/docs/deployment/http.mdxindex f7a58b698..afe09d33e 100644--- a/docs/deployment/http.mdx+++ b/docs/deployment/http.mdx@@ -961,4 +961,4 @@ This guide has shown you how to create an HTTP-accessible MCP server, but you'll- **Edge platforms** (Cloudflare Workers)- **Kubernetes clusters** (self-managed or managed)-The key requirements are Python 3.10+ support and the ability to expose an HTTP port. Most providers will require you to package your server (requirements.txt, Dockerfile, etc.) according to their deployment format. For managed, zero-configuration deployment, see [Prefect Horizon](/deployment/prefect-horizon).+The key requirements are Python 3.10+ support and the ability to expose an HTTP port. Most providers will require you to package your server (requirements.txt, Dockerfile, etc.) according to their deployment format. For managed, zero-configuration deployment, see [FastMCP Gateway](/deployment/fastmcp-gateway).diff --git a/docs/deployment/server-configuration.mdx b/docs/deployment/server-configuration.mdxindex dc630cd1f..511fad892 100644--- a/docs/deployment/server-configuration.mdx+++ b/docs/deployment/server-configuration.mdx@@ -132,7 +132,7 @@ The source configuration determines **WHERE** your server code lives. It tells FFuture releases will support additional source types:- **Git repositories** (`type: "git"`) for loading server code directly from version control-- **Prefect Horizon** (`type: "cloud"`) for hosted servers with automatic scaling and management+- **FastMCP Gateway** (`type: "cloud"`) for hosted servers with automatic scaling and management</Note>### Environment Configurationdiff --git a/docs/docs.json b/docs/docs.jsonindex d3ce0cef9..49afbfb9c 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -73,7 +73,7 @@{"href": "https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_horizon&utm_content=header","icon": "cloud",- "label": "Prefect Horizon"+ "label": "FastMCP Gateway"}],"primary": {@@ -202,7 +202,7 @@"deployment/running-server","deployment/http","deployment/sandboxed-agents",- "deployment/prefect-horizon",+ "deployment/fastmcp-gateway","deployment/server-configuration","servers/testing","servers/telemetry"@@ -488,11 +488,15 @@"source": "/clients/generate-cli"},{- "destination": "/deployment/prefect-horizon",+ "destination": "/deployment/fastmcp-gateway",+ "source": "/deployment/prefect-horizon"+ },+ {+ "destination": "/deployment/fastmcp-gateway","source": "/deployment/fastmcp-cloud"},{- "destination": "/deployment/prefect-horizon",+ "destination": "/deployment/fastmcp-gateway","source": "/v2/deployment/fastmcp-cloud"},{diff --git a/docs/getting-started/quickstart.mdx b/docs/getting-started/quickstart.mdxindex 79c4599a3..de2c2d3c6 100644--- a/docs/getting-started/quickstart.mdx+++ b/docs/getting-started/quickstart.mdx@@ -146,18 +146,18 @@ You can preview app tools locally with `fastmcp dev apps my_server.py` — no MCFastMCP HTTP servers run anywhere you can host a Python application. The [HTTP deployment guide](/deployment/http) covers the transport settings and security boundaries for self-managed infrastructure.-For a managed deployment, [Prefect Horizon](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) is the enterprise MCP platform built by the FastMCP team at [Prefect](https://www.prefect.io). It provides hosting, authentication, access control, and observability for MCP servers.+For a managed deployment, [FastMCP Gateway](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) is the enterprise MCP platform built by the FastMCP team at [Prefect](https://www.prefect.io). It provides hosting, authentication, access control, and observability for MCP servers.<Info>-Horizon is **free for personal projects** and offers enterprise governance for teams.+FastMCP Gateway is **free for personal projects** and offers enterprise governance for teams.</Info>To deploy your server, you'll need a [GitHub account](https://github.com). Once you have one, you can deploy your server in three steps:1. Push your `my_server.py` file to a GitHub repository-2. Sign in to [Prefect Horizon](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) with your GitHub account+2. Sign in to [FastMCP Gateway](https://horizon.prefect.io?utm_source=gofastmcp&utm_medium=docs) with your GitHub account3. Create a new project from your repository and enter `my_server.py:mcp` as the server entrypoint-That's it! Horizon will build and deploy your server, making it available at a URL like `https://your-project.fastmcp.app/mcp`. You can chat with it to test its functionality, or connect to it from any LLM client that supports the MCP protocol.+FastMCP Gateway will build and deploy your server, making it available at a URL like `https://your-project.fastmcp.app/mcp`. You can chat with it to test its functionality, or connect to it from any LLM client that supports the MCP protocol.-For more details, see the [Prefect Horizon guide](/deployment/prefect-horizon).+For more details, see the [FastMCP Gateway guide](/deployment/fastmcp-gateway).diff --git a/docs/getting-started/welcome.mdx b/docs/getting-started/welcome.mdxindex eec65fe0d..785d121c3 100644--- a/docs/getting-started/welcome.mdx+++ b/docs/getting-started/welcome.mdx@@ -90,15 +90,17 @@ FastMCP is made with 💙 by [Prefect](https://www.prefect.io/).**This documentation reflects FastMCP's `main` branch**, so it may describe features that have not reached a stable release. Version badges identify when features were introduced.</Tip>-## Scale MCP with Horizon+<a id="scale-mcp-with-horizon" />-FastMCP handles the MCP application layer. **[Prefect Horizon](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_welcome&utm_content=welcome_body)** is the enterprise MCP gateway for scaling servers and tools across teams, with centralized governance over how they are deployed, discovered, secured, and used.+## Scale MCP with FastMCP Gateway-Horizon applies the operational patterns developed while maintaining FastMCP: deploy servers from GitHub with branch previews and instant rollback, organize them in a private registry, protect access with SSO and tool-level RBAC, and observe activity through audit logs and telemetry.+FastMCP handles the MCP application layer. **[FastMCP Gateway](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_welcome&utm_content=welcome_body)** is the enterprise MCP gateway for scaling servers and tools across teams, with centralized governance over how they are deployed, discovered, secured, and used.-Horizon can also combine approved tools into purpose-built MCP endpoints for different teams and agents, while keeping access policy and governance centralized.+FastMCP Gateway applies the operational patterns developed while maintaining FastMCP: deploy servers from GitHub with branch previews and instant rollback, organize them in a private registry, protect access with SSO and tool-level RBAC, and observe activity through audit logs and telemetry.-Start with FastMCP. [Scale with Horizon →](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_welcome&utm_content=welcome_cta)+FastMCP Gateway can also combine approved tools into purpose-built MCP endpoints for different teams and agents, while keeping access policy and governance centralized.++Start with FastMCP. [Scale with FastMCP Gateway →](https://www.prefect.io/horizon?utm_source=gofastmcp&utm_medium=docs&utm_campaign=docs_welcome&utm_content=welcome_cta)## LLM-friendly docsdiff --git a/docs/unify-intent.js b/docs/unify-intent.jsindex b51e57b5a..0a24a2983 100644--- a/docs/unify-intent.js+++ b/docs/unify-intent.js@@ -9,7 +9,8 @@path.includes("/clients/auth/") ||path.includes("/deployment/running-server") ||path.includes("/deployment/http") ||- path.includes("/deployment/prefect-horizon")+ path.includes("/deployment/prefect-horizon") ||+ path.includes("/deployment/fastmcp-gateway"));}diff --git a/docs/v2-navigation.json b/docs/v2-navigation.jsonindex 17865edfd..ab2f9dc79 100644--- a/docs/v2-navigation.json+++ b/docs/v2-navigation.json@@ -60,7 +60,7 @@"pages": ["v2/deployment/running-server","v2/deployment/http",- "deployment/prefect-horizon",+ "deployment/fastmcp-gateway","v2/deployment/server-configuration"]}diff --git a/fastmcp_slim/README.md b/fastmcp_slim/README.mdindex 4a813d96b..a9b155fc6 100644--- a/fastmcp_slim/README.md+++ b/fastmcp_slim/README.md@@ -79,15 +79,17 @@ FastMCP has three pillars:Ready to build? Start with the [installation guide](https://gofastmcp.com/getting-started/installation) or jump straight to the [quickstart](https://gofastmcp.com/getting-started/quickstart).-## Run FastMCP in production with Horizon+<a id="run-fastmcp-in-production-with-horizon"></a>-FastMCP is the standard way to build MCP servers. **[Prefect Horizon](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_body)** is the enterprise MCP gateway for running them safely.+## Run FastMCP in production with FastMCP Gateway-Built by the FastMCP team, Horizon packages the best practices we've learned shipping the world's most popular MCP framework.+FastMCP is the standard way to build MCP servers. **[FastMCP Gateway](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_body)** is the enterprise MCP gateway for running them safely.++Built by the FastMCP team, FastMCP Gateway applies the operational patterns we've developed while maintaining the world's most popular MCP framework.Deploy FastMCP servers from GitHub with branch previews and instant rollback. Create a private registry of every MCP your company uses. Secure access with SSO and tool-level RBAC. Get audit logs, observability, and governance across your MCP stack. Remix approved tools into purpose-built endpoints for teams and agents.-Start with FastMCP. [Scale with Horizon →](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_cta)+Start with FastMCP. [Scale with FastMCP Gateway →](https://www.prefect.io/horizon?utm_source=github&utm_medium=readme&utm_campaign=readme_horizon&utm_content=readme_cta)## Installation