Fingerprint MCP Server

Features

• Run locally or use managed instance at https://mcp.fpjs.io/mcp
• Event tools: Retrieve and search identification events with full smart signal data
• Management tools: Manage workspace environments and API keys
• Onboarding prompt: Guided setup for integrating Fingerprint into a project
• Supports both stdio and streamable-http transports
• Optional HTTPS with TLS certificates
• OAuth2 login supported
• Public mode for multi-tenant deployments (API keys passed via JWT bearer token)
• Tool filtering to control which tools are exposed
• Configurable via environment variables or CLI flags
• Docker support for easy deployment

Installation

From Source

go install github.com/fingerprintjs/fingerprint-mcp-server@latest

Build Locally

git clone https://github.com/fingerprintjs/fingerprint-mcp-server.git
cd fingerprint-mcp-server
make build

make build runs go generate (to download the OpenAPI spec and generate schema files under internal/schema/) and then builds the binary.

Configuration

The server can be configured via CLI flags or environment variables:

Usage

Private mode vs. Public mode

Private mode means the server runs with its API keys pre-configured (FINGERPRINT_SERVER_API_KEY and FINGERPRINT_MANAGEMENT_API_KEY). This mode is useful when you are running a local instance intended to be used within your organization: server automatically uses those specified in the config. In this mode, auth token (MCP_AUTH_TOKEN) is enforced to protect your instance of the MCP server from unauthenticated use.

Public mode is how https://mcp.fpjs.io/mcp is run. It is meant to be used in situations when a single instance can be used by different users from different organizations, each with their own API keys. In this mode, API keys are extracted from JWT access tokens that are issued by https://dashboard.fingerprint.com or by user following the OAuth2 flow.

Stdio Transport (Default)

export FINGERPRINT_SERVER_API_KEY=your-secret-api-key
./fingerprint-mcp-server

Streamable HTTP Transport

export FINGERPRINT_SERVER_API_KEY=your-secret-api-key
./fingerprint-mcp-server --transport=streamable-http --port=8080

The MCP endpoint will be available at http://localhost:8080/mcp.

HTTPS

Provide TLS certificate and key files to enable HTTPS:

./fingerprint-mcp-server --transport=streamable-http \
  --tls-cert=cert.pem --tls-key=key.pem

Tool Filtering

By default, all tools are registered based on which API keys are configured. You can restrict which tools are exposed:

# Only expose read-only tools
./fingerprint-mcp-server --read-only

# Expose a specific set of tools
./fingerprint-mcp-server --tools=get_event,search_events,list_environments

When --tools is set, it overrides --read-only.

Docker

Build the Image

docker build -t fingerprint-mcp-server .

Run with Stdio Transport

docker run -i --rm \
  -e FINGERPRINT_SERVER_API_KEY=your-secret-api-key \
  fingerprint-mcp-server

Run with Streamable HTTP Transport

docker run -d --rm \
  -e FINGERPRINT_SERVER_API_KEY=your-secret-api-key \
  -e MCP_TRANSPORT=streamable-http \
  -p 8080:8080 \
  fingerprint-mcp-server

MCP Client Configuration

Add to your Cursor/Claude Desktop/etc configuration file (e.g. claude_desktop_config.json):

Stdio Transport:

{
  "mcpServers": {
    "fingerprint": {
      "command": "/path/to/fingerprint-mcp-server",
      "env": {
        "FINGERPRINT_SERVER_API_KEY": "your-secret-api-key"
      }
    }
  }
}

Streamable HTTP Transport:

{
  "mcpServers": {
    "fingerprint": {
      "url": "https://url/mcp",
      "headers": {
        "Authorization": "Bearer <auth-token>"
      }
    }
  }
}

Docker with Stdio:

{
  "mcpServers": {
    "fingerprint": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FINGERPRINT_SERVER_API_KEY=your-secret-api-key", "fingerprint-mcp-server"]
    }
  }
}

Available Tools

Event tools require a Server API key. Management tools require a Management API key. Write tools (create/update/delete) are hidden when --read-only is set or excluded via --tools.

Available Resources

• fingerprint://events/{event_id} — Returns full event data for a given event ID.
• fingerprint://schemas/event — JSON Schema describing the event output structure.
• fingerprint://schemas/environment — JSON Schema for environment objects.
• fingerprint://schemas/api-key — JSON Schema for API key objects.

Available Prompts

• onboarding — A guided walkthrough for integrating Fingerprint into a project, covering JavaScript Agent installation, API key setup, and verification steps.

License

MIT