Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.fusionauth/mcp-api

NPM · @FUSIONAUTH/MCP-API · SCANNED AUG 3

Preview release of FusionAuth API MCP server

Available components

+20 this week 66 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security88
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (110 of 111), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (110 of 111), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability60
  • AI-judged instruction clarity (fair).Partial
  • Tool/resource definitions use about 22835 tokens (~73/item across 310 items; 310 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage99
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 97% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @fusionauth/mcp-api

# add to Claude Code
claude mcp add io-fusionauth-mcp-api -- npx -y @fusionauth/mcp-api
# add to Codex CLI
codex mcp add io-fusionauth-mcp-api -- npx -y @fusionauth/mcp-api
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-fusionauth-mcp-api": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@fusionauth/mcp-api"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add io-fusionauth-mcp-api --command npx --arg -y --arg @fusionauth/mcp-api
# ~/.hermes/config.yaml
mcp_servers:
  io-fusionauth-mcp-api:
    command: "npx"
    args: ["-y", "@fusionauth/mcp-api"]
// mcp.json
{
  "mcpServers": {
    "io-fusionauth-mcp-api": {
      "command": "npx",
      "args": [
        "-y",
        "@fusionauth/mcp-api"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +30
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Security disclosure: fail → unverified functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Stability: unverified → 0.23 functional
    • License: unverified → pass functional
    • Schema quality: unverified → fair functional
    • Licence: Apache-2.0 functional
  • 1 Aug 26 +15
    • Malware scan: unverified → pass security
  • 31 Jul 26 −25
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 46

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@fusionauth/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 110 packages

110 packages in the resolved dependency tree · 109 deprecated · 32 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 310 exposed · ~22,835 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
updateUserVerifyEmail ~146

Re-sends the verification email to the user. If the Application has configured a specific email template this will be used instead of the tenant configuration. OR Re-sends the verification email to the user. OR Generate a new Email Verification Id to be used with the Verify Email API. This API will not attempt to send an email to the User. This API may be used to collect the verificationId for use with a third party system.

NameTypeReqDescription
applicationIdstringThe unique Application Id to used to resolve an application specific email template.
emailstringThe email address of the user that needs a new verification email.
sendVerifyEmailstring

No output schema declared.

No examples provided.

updateUserVerifyRegistration ~115

Re-sends the application registration verification email to the user. OR Generate a new Application Registration Verification Id to be used with the Verify Registration API. This API will not attempt to send an email to the User. This API may be used to collect the verificationId for use with a third party system.

NameTypeReqDescription
applicationIdstringThe Id of the application to be verified.
emailstringThe email address of the user that needs a new verification email.
sendVerifyPasswordEmailstring

No output schema declared.

No examples provided.

updateUserWithId ~108

Updates the user with the given Id. OR Reactivates the user with the given Id.

NameTypeReqDescription
X-FusionAuth-TenantIdstringThe unique Id of the tenant used to scope this API request. Only required when there is more than one tenant and the API key is not tenant-scoped.
reactivatestring
requestBodyobjectUser API request object.
userIdstringyesThe Id of the user to update.

No output schema declared.

No examples provided.

updateWebhookWithId ~46

Updates the webhook with the given Id.

NameTypeReqDescription
requestBodyobjectWebhook API request object.
webhookIdstringyesThe Id of the webhook to update.

No output schema declared.

No examples provided.

upsertEntityGrantWithId ~113

Creates or updates an Entity Grant. This is when a User/Entity is granted permissions to an Entity.

NameTypeReqDescription
X-FusionAuth-TenantIdstringThe unique Id of the tenant used to scope this API request. Only required when there is more than one tenant and the API key is not tenant-scoped.
entityIdstringyesThe Id of the Entity that the User/Entity is being granted access to.
requestBodyobjectEntity grant API request object.

No output schema declared.

No examples provided.

validateDeviceWithId ~74

Validates the end-user provided user_code from the user-interaction of the Device Authorization Grant. If you build your own activation form you should validate the user provided code prior to beginning the Authorization grant.

NameTypeReqDescription
client_idstringThe client Id.
user_codestringThe end-user verification code.

No output schema declared.

No examples provided.

validateJWTWithId ~63

Validates the provided JWT (encoded JWT string) to ensure the token is valid. A valid access token is properly signed and not expired. <p> This API may be used to verify the JWT as well as decode the encoded JWT into human readable identity claims.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

vendJWTWithId ~150

It's a JWT vending machine! Issue a new access token (JWT) with the provided claims in the request. This JWT is not scoped to a tenant or user, it is a free form token that will contain what claims you provide. <p> The iat, exp and jti claims will be added by FusionAuth, all other claims must be provided by the caller. If a TTL is not provided in the request, the TTL will be retrieved from the default Tenant or the Tenant specified on the request either by way of the X-FusionAuth-TenantId request header, or a tenant scoped API key.

NameTypeReqDescription
requestBodyobjectThe JSON request body.

No output schema declared.

No examples provided.

verifyIdentityWithId ~36

Administratively verify a user identity.

NameTypeReqDescription
requestBodyobjectIdentity verify request. Used to administratively verify an identity.

No output schema declared.

No examples provided.

verifyUserRegistrationWithId ~131

Confirms a user's registration. The request body will contain the verificationId. You may also be required to send a one-time use code based upon your configuration. When the application is configured to gate a user until their registration is verified, this procedures requires two values instead of one. The verificationId is a high entropy value and the one-time use code is a low entropy value that is easily entered in a user interactive form. The two values together are able to confirm a user's registration and mark the user's registration as verified.

NameTypeReqDescription
requestBodyobjectThe JSON request body.

No output schema declared.

No examples provided.