playbooks

home / mcp / preview fusionauth api mcp server

Preview FusionAuth API MCP Server

Provides an MCP server interface to access FusionAuth API endpoints for read and write operations.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "fusionauth-fusionauth-mcp-api": {
      "command": "npx",
      "args": [
        "@fusionauth/mcp-api"
      ],
      "env": {
        "USE_TOOLS": "retrieve,search",
        "API_BASE_URL": "http://localhost:9011",
        "API_KEY_APIKEYAUTH": "<your fusionauth api key>"
      }
    }
  }
}

You can access FusionAuth API endpoints through an MCP server that translates FusionAuth API capabilities into tools you can use with your MCP client. This preview server lets you read and manage FusionAuth data via familiar MCP tooling while keeping integration patterns consistent with other MCP servers.

How to use

Set up your MCP client to use the FusionAuth MCP server. You can run the server locally or point your client at a development instance. Use the provided environment variables to supply your FusionAuth API key, base URL, and the tools you want to enable.

How to install

Prerequisites you need before installation:

  • A running FusionAuth instance
  • Node.js (for local builds and execution)

Choose one of the installation paths below. Follow the steps exactly to ensure the MCP server runs as expected.

Additional sections

Configuration and runtime options are described here to help you tailor the MCP server to your environment. You will learn how to secure access, restrict available tools to manage context window usage, and address common troubleshooting tasks.

Available tools

create

Tools that invoke API endpoints to create new FusionAuth entities such as applications, tenants, users, or other resources.

delete

Tools that invoke API endpoints to remove FusionAuth resources, such as users or configurations.

patch

Tools that invoke API endpoints to update partial fields of FusionAuth resources.

update

Tools that invoke API endpoints to replace or modify existing FusionAuth resources.

retrieve

Tools that invoke API endpoints to read or fetch FusionAuth data like applications, users, or configurations.

search

Tools that invoke API endpoints to search or filter FusionAuth data.