Fusio

v1.0.0APIsstable

Self-Hosted API Management for Builders

aiai-agentsapiapi-gatewayapi-management
Share:
2,094
Stars
0
Downloads
0
Weekly
0/5

What is Fusio?

Fusio is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to self-hosted api management for builders

Self-Hosted API Management for Builders

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Self-Hosted API Management for Builders

Use Cases

Self-hosted API management and gateway
apioo

Maintainer

LicenseApache-2.0
Languagephp
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx fusio

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Fusio

Fusio is a self-hosted open-source API management platform that lets developers build, deploy, and expose REST and GraphQL APIs without boilerplate. It includes native support for the Model Context Protocol so that AI agents can discover and invoke the APIs you define inside Fusio through an MCP interface. Teams use it as a backend-as-a-service layer that sits between their databases or microservices and AI tools, enabling AI agents to call business logic endpoints with full access control and rate limiting.

Prerequisites

  • PHP 8.1+ runtime (for manual installation) or Docker and Docker Compose
  • A supported database: MySQL 8.0+, PostgreSQL, or SQLite
  • Composer (PHP dependency manager) if installing manually
  • A running MCP client such as Claude Desktop, Cursor, or Claude Code
  • Optional: Ollama, OpenAI API key, or Gemini API key for AI-powered action generation
1

Start Fusio with Docker Compose

The fastest way to run Fusio is with Docker. Create a docker-compose.yml using the official image and set the required environment variables, then bring the stack up.

docker compose up -d
2

Configure the required environment variables

Fusio reads its core settings from environment variables. Set these before or inside your docker-compose.yml.

FUSIO_CONNECTION=mysql://root:password@db/fusio
FUSIO_PROJECT_KEY=your-secret-key
FUSIO_BACKEND_USER=admin
[email protected]
FUSIO_BACKEND_PW=your-admin-password
APP_URL=http://localhost:8080
3

Run database migrations and create admin user

If installing manually (without Docker), run the migration command to create the schema, then create the initial administrator account.

php bin/fusio migrate
php bin/fusio adduser
php bin/fusio marketplace:install fusio
4

Access the Fusio backend and define APIs

Open http://localhost:8080/apps/fusio in your browser and log in with your admin credentials. Create operations, define schemas, and connect action handlers to your database or microservices. Each operation you publish is discoverable through the MCP interface.

5

Connect an MCP client

Fusio exposes its APIs as MCP tools. Point your MCP client at the Fusio MCP endpoint. The exact endpoint path depends on your Fusio version — check the Fusio backend under System > MCP for the URL and any required API token.

{
  "mcpServers": {
    "fusio": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Fusio Examples

Client configuration

HTTP-based MCP client configuration pointing at a local Fusio instance. Replace the URL with your actual Fusio host and add an Authorization header if API key auth is enabled.

{
  "mcpServers": {
    "fusio": {
      "type": "http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer your-fusio-api-token"
      }
    }
  }
}

Prompts to try

After connecting an AI client to Fusio's MCP endpoint, you can invoke your published API operations using natural language.

- "List all available API operations in Fusio."
- "Call the /api/products endpoint and return the first 10 results."
- "Generate an action for this operation: return a list of popular composers of the 19th century."
- "Create a new API route in Fusio that returns user statistics from the database."
- "Show me the schema for the /api/orders endpoint."

Troubleshooting Fusio

docker compose up fails with database connection errors

Ensure FUSIO_CONNECTION uses the correct hostname for the database container (e.g., 'db' when using Docker Compose service names, not 'localhost'). Wait for the database container to be fully healthy before the Fusio container starts — add a depends_on health check in your compose file.

MCP client cannot discover Fusio tools or gets a 401 error

Generate an API token in the Fusio backend under Security > Apps and add it as an Authorization: Bearer header in your MCP client config. Also confirm the MCP endpoint URL matches your APP_URL setting.

AI action generation returns errors about missing AI provider config

Fusio's AI-powered action generation requires an AI provider. Set the appropriate credentials in the Fusio backend under System > Config: choose Ollama (local), OpenAI (add your OpenAI key), or Gemini (add your Gemini key).

Frequently Asked Questions about Fusio

What is Fusio?

Fusio is a Model Context Protocol (MCP) server that self-hosted api management for builders It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Fusio?

Follow the installation instructions on the Fusio GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Fusio?

Fusio works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Fusio free to use?

Yes, Fusio is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "fusio": { "command": "npx", "args": ["-y", "fusio"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Fusio?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides