lane-mcp-auth

OAuth 2.1 resource server and consent gate for an MCP server behind Lane — the Python distribution of @lane/mcp-auth.

pip install lane-mcp-auth          # core
pip install 'lane-mcp-auth[fastmcp]'   # + the FastMCP helpers

Your server verifies bearer tokens, publishes the discovery document clients need, and refuses every tool until the caller holds a recorded, revocable grant.

from lane_mcp_auth import LaneMcpAuth

auth = LaneMcpAuth(
    resource="https://acme.example/mcp",
    connections=connections,   # yours: this is server-side state
    exchanger=exchanger,
)

The three tiers

tier	reached by	declared
authenticated only	—	not registrable
any connected caller	completing the step-up	no scope
a specific authority	the step-up granting it	`scope="…"`

Registration is the floor. Omitting a scope means any connected caller, never anyone: a session that has not registered has nothing anyone can revoke, so a tool answering it would be answering something nobody can withdraw.

With FastMCP

from lane_mcp_auth.fastmcp import register_step_up_tool, guarded

register_step_up_tool(mcp, auth)

@mcp.tool()
@guarded(auth, "read_orders", scope="email")
async def read_orders(ctx) -> str:
    return await orders_for(ctx)

Never authorize on the token's scopes

claims.scopes is the token's own claim: empty before the step-up, stale after. Authority lives in the connection and is reachable only through has_scope() / effective_scopes(), because Lane decides it at exchange time and can refuse an exchange it would previously have allowed. A signed claim cannot be withdrawn.

Parity with the TypeScript

Same invariants, same names where Python idiom allows. The TypeScript package is the reference implementation; where the two could drift — scope filtering, the metadata paths, the gate's decision table — see SCOPE.md for what is implemented here and what is not yet.

Licence

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lane_mcp_auth-0.1.1.tar.gz (140.2 kB view details)

Uploaded Aug 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

lane_mcp_auth-0.1.1-py3-none-any.whl (16.4 kB view details)

Uploaded Aug 21, 2026 Python 3

File details

Details for the file lane_mcp_auth-0.1.1.tar.gz.

File metadata

Download URL: lane_mcp_auth-0.1.1.tar.gz
Upload date: Aug 21, 2026
Size: 140.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lane_mcp_auth-0.1.1.tar.gz
Algorithm	Hash digest
SHA256	`d4ef87c976f0fbf04138fe59001c15a9ac29c04b8d8447617b9e9fce29b31c16`
MD5	`3e71b7b833ce4ac171adee122eb9eadf`
BLAKE2b-256	`5ee7f1eb6bd2364dae183ae552b55c9724b2375c2ca55a5a34d9836f2f376635`

See more details on using hashes here.

Provenance

The following attestation bundles were made for lane_mcp_auth-0.1.1.tar.gz:

Publisher: publish-mcp-auth.yml on Lane-Technologies-Inc/lane

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: lane_mcp_auth-0.1.1.tar.gz
- Subject digest: d4ef87c976f0fbf04138fe59001c15a9ac29c04b8d8447617b9e9fce29b31c16
- Sigstore transparency entry: 2541653652
- Sigstore integration time: Aug 21, 2026
Source repository:
- Permalink: Lane-Technologies-Inc/lane@63b8e7cb538af81ef9b9068f134ba6fa4a5f4d10
- Branch / Tag: refs/heads/agent/derive-at-draft-20260813-b7e2
- Owner: https://github.com/Lane-Technologies-Inc
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-mcp-auth.yml@63b8e7cb538af81ef9b9068f134ba6fa4a5f4d10
- Trigger Event: push