FastMCP and FGA Tutorial

A Model Context Protocol (MCP) server built with FastMCP and integrated with Auth0 FGA (Fine-Grained Authorization) for document access control.

You can find the tutorial with all the steps to setup and use this repository.

Prerequisites

• Node.js v18 or higher
• npm (comes with Node.js)
• An Auth0 account → Sign up free
• An Auth0 FGA account → Sign up free

Project Structure

fastmcp-fga/
├── src/
│   ├── index.ts        # MCP server entry point
│   └── documentApi.ts  # Document data & API
├── package.json
├── tsconfig.json
└── .env                # Your local config (not committed)

Install dependencies

    npm install

Configuration

Use the file .env.sample as base app and get the values on Auth0 and Auth0 FGA accounts.

Starting The Application

Run the following command and copy the generated URL:

    npm start

Using Inspector for Debugging

Start inspector with:

npx @modelcontextprotocol/inspector@latest

Use the URL provided by Inspector and open it on your browser. Use the FastMCP URL and click connect.

License

Copyright 2026 Okta, Inc.

This project is licensed under the Apache License 2.0. See the LICENSE file for more info.