1.0.5 • Published 5 months ago

generic-mcp-server v1.0.5

Weekly downloads
-
License
ISC
Repository
-
Last release
5 months ago

Auth0 MCP Server

A Model Context Protocol (MCP) server implementation for integrating Auth0 Management API with Claude Desktop.

Quick Setup

Prerequisites

  • Node.js v18 or higher
  • Git

Installation

  1. Clone and build the Auth0 CLI with MCP support:

    # Clone the Auth0 CLI with MCP support
    git clone -b mcp-server https://github.com/bharath31/auth0-cli
    cd auth0-cli
    
    # Build the CLI
    make build
    
    # Login to Auth0
    ./out/auth0 login
  2. Clone and build the Auth0 MCP server:

    # Go back to the root directory
    cd..
    
    # Clone the repository
    git clone https://github.com/bharath31/auth0-mcp-server
    cd auth0-mcp-server
    
    # Install dependencies
    npm install
    
    # Automatically detect and configure Auth0 CLI path
    npm run setup
    
    # Build the server
    npm run build
  3. Configure Claude Desktop:

    # From the auth0-cli directory
    ./out/auth0 mcp init

    This command configures Claude Desktop to use the Auth0 MCP server. It automatically manages the server process, so you don't need to run it manually.

Supported Tools

The Auth0 MCP Server provides the following tools for Claude to interact with your Auth0 tenant:

Tool NameDescription
Applications
auth0_list_applicationsList all applications in the Auth0 tenant
auth0_get_applicationGet details about a specific Auth0 application
auth0_search_applicationsSearch for applications by name
auth0_create_applicationCreate a new Auth0 application
auth0_update_applicationUpdate an existing Auth0 application
auth0_delete_applicationDelete an Auth0 application
Resource Servers
auth0_list_resource_serversList all resource servers (APIs) in the Auth0 tenant
auth0_get_resource_serverGet details about a specific Auth0 resource server
auth0_create_resource_serverCreate a new Auth0 resource server (API)
auth0_update_resource_serverUpdate an existing Auth0 resource server
auth0_delete_resource_serverDelete an Auth0 resource server
Actions
auth0_list_actionsList all actions in the Auth0 tenant
auth0_get_actionGet details about a specific Auth0 action
auth0_create_actionCreate a new Auth0 action
auth0_update_actionUpdate an existing Auth0 action
auth0_delete_actionDelete an Auth0 action
auth0_deploy_actionDeploy an Auth0 action
Logs
auth0_list_logsList logs from the Auth0 tenant
auth0_get_logGet a specific log entry by ID
auth0_search_logsSearch logs with specific criteria
Forms
auth0_list_formsList all forms in the Auth0 tenant
auth0_get_formGet details about a specific Auth0 form
auth0_create_formCreate a new Auth0 form
auth0_update_formUpdate an existing Auth0 form
auth0_delete_formDelete an Auth0 form
auth0_publish_formPublish an Auth0 form

Modes of Operation

The server supports two modes when used with the Auth0 CLI:

Production Mode (Default)

  • Uses the global Auth0 CLI in your PATH
  • Minimal logging

Debug Mode

  • Uses a local Auth0 CLI path when available
  • More detailed logging
  • Enable by setting environment variable: export AUTH0_MCP_DEBUG=true

Troubleshooting

If you encounter issues with the Auth0 CLI path:

  1. The npm run setup command automatically detects your Auth0 CLI path
  2. You can manually set the path: export AUTH0_CLI_PATH=/path/to/auth0-cli/auth0
  3. Run the validator to check your setup: npm run utils:validate-env

Testing

# Test the connection
npm test

# Test a specific tool call
npm run test:tools

Additional Information

For more detailed information, check the documentation in the docs directory.

1.0.5

5 months ago

1.0.4

5 months ago

1.0.3

5 months ago

1.0.2

5 months ago

1.0.1

5 months ago

1.0.0

5 months ago