[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_106":107},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@fingerprintjs/fingerprint-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":46,"_48":49,"_50":51,"_52":53,"_54":46,"_55":56,"_57":58,"_59":60,"_61":62,"_63":64,"_65":46,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":-5,"_78":-5,"_79":46,"_80":-5,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94},"apiUrl","https://odel.app/api","creator","fingerprintjs","moduleId","fingerprint-mcp-server","@fingerprintjs/fingerprint-mcp-server","displayName","Fingerprint","tagline","Device intelligence for AI agents: Fingerprint events, smart signals, and API key management.","iconKey","https://avatars.githubusercontent.com/u/67208791?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.fpjs.io/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781670029000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.fingerprintjs%2Ffingerprint-mcp-server","sourceVerified",true,"importedAt","upstreamStars",3,"upstreamUpdatedAt",1781619561000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/fingerprintjs/fingerprint-mcp-server","githubRepoFullName","fingerprintjs/fingerprint-mcp-server","releaseId","ext-fingerprintjs-fingerprint-mcp-server","version","0.1.35","descriptionMarkdown","

\n \n \n \n \n $\"Fingerprint$ \n \n \n

\n\n# Fingerprint MCP Server\n\n## Features\n\n- Run locally or use managed instance at https://mcp.fpjs.io/mcp\n- **Event tools**: Retrieve and search identification events with full smart signal data\n- **Management tools**: Manage workspace environments and API keys\n- **Onboarding prompt**: Guided setup for integrating Fingerprint into a project\n- Supports both **stdio** and **streamable-http** transports\n- Optional HTTPS with TLS certificates\n- OAuth2 login supported\n- **Public mode** for multi-tenant deployments (API keys passed via JWT bearer token)\n- **Tool filtering** to control which tools are exposed\n- Configurable via environment variables or CLI flags\n- Docker support for easy deployment\n\n## Installation\n\n### From Source\n\n```bash\ngo install github.com/fingerprintjs/fingerprint-mcp-server@latest\n```\n\n### Build Locally\n\n```bash\ngit clone https://github.com/fingerprintjs/fingerprint-mcp-server.git\ncd fingerprint-mcp-server\nmake build\n```\n\n`make build` runs `go generate` (to download the OpenAPI spec and generate schema files under `internal/schema/`) and then builds the binary.\n\n## Configuration\n\nThe server can be configured via CLI flags or environment variables:\n\n| CLI Flag | Environment Variable | Default | Description |\n|------------------------|----------------------------------|----------------------------------|--------------------------------------------------------------------------|\n| `--server-api-key` | `FINGERPRINT_SERVER_API_KEY` | | Fingerprint Server API key (private mode) |\n| `--server-api-url` | `FINGERPRINT_SERVER_API_URL` | api.fpjs.io | Custom Server API URL (omit to use default) |\n| `--management-api-key` | `FINGERPRINT_MANAGEMENT_API_KEY` | | Fingerprint Management API key (private mode) |\n| `--management-api-url` | `FINGERPRINT_MANAGEMENT_API_URL` | management-api.fpjs.io | Custom Management API URL (omit to use default) |\n| `--region` | `FINGERPRINT_REGION` | `us` | API region: `us`, `eu`, or `ap` (private mode) |\n| `--transport` | `MCP_TRANSPORT` | `stdio` | Transport: `stdio` or `streamable-http` |\n| `--port` | `MCP_PORT` | `8080` | Port for HTTP/HTTPS server |\n| `--tls-cert` | `MCP_TLS_CERT` | | Path to TLS certificate file |\n| `--tls-key` | `MCP_TLS_KEY` | | Path to TLS private key file |\n| `--read-only` | `MCP_READ_ONLY` | `false` | Only expose read tools (shorthand for `--tools` with read-only tools) |\n| `--tools` | `MCP_TOOLS` | | Comma-separated list of tool names to register (overrides `--read-only`) |\n| `--public` | `MCP_PUBLIC` | `false` | Public mode: extract API keys from JWT bearer tokens |\n| `--auth-token` | `MCP_AUTH_TOKEN` | (auto-generated in private mode) | Bearer token required to access the server (private mode) |\n| `--jwt-public-key` | `FINGERPRINT_PUBLIC_KEY` | | PEM-encoded ES256 public key for verifying Fingerprint-issued JWT tokens |\n| `--oauth-resource` | `OAUTH_RESOURCE` | | URL of this server (for OAuth metadata) |\n| `--oauth-auth-server` | `OAUTH_AUTH_SERVER` | | URL of the OAuth authorization server |\n| `--jwks-url` | `JWKS_URL` | | JWKS URL for JWT token verification in public mode |\n\n## Telemetry\n\nThis binary ships with telemetry disabled. There is no built-in analytics\nbackend and the default emitter is a no-op, so running the OSS binary\nsends nothing to anyone.\n\nThe server exposes a hook (`analytics.Emitter` in the `analytics`\npackage) that fires on each MCP method. Embedders who want product\nanalytics register their own emitter by importing this package as a\nlibrary and calling `WithAnalytics(emitter)` when constructing the\nserver. Fingerprint's hosted build (`mcp.fpjs.io`) does this with an\nAmplitude emitter, but that implementation lives in the private managed\nrepo, not here.\n\nIf you build your own emitter, the event shape is in\n`analytics/analytics.go`. The middleware fires one `mcp_method_called`\nevent per MCP method, gated on a non-empty `subscription_id` (so pre-auth\nmethods and the private-mode auth path stay silent regardless).\n\n## Usage\n\n### Private mode vs. Public mode\n\nPrivate 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.\n\nPublic 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.\n\n### Stdio Transport (Default)\n\n```bash\nexport FINGERPRINT_SERVER_API_KEY=your-secret-api-key\n./fingerprint-mcp-server\n```\n\n### Streamable HTTP Transport\n\n```bash\nexport FINGERPRINT_SERVER_API_KEY=your-secret-api-key\n./fingerprint-mcp-server --transport=streamable-http --port=8080\n```\n\nThe MCP endpoint will be available at `http://localhost:8080/mcp`.\n\n### HTTPS\n\nProvide TLS certificate and key files to enable HTTPS:\n\n```bash\n./fingerprint-mcp-server --transport=streamable-http \\\n --tls-cert=cert.pem --tls-key=key.pem\n```\n\n### Tool Filtering\n\nBy default, all tools are registered based on which API keys are configured. You can restrict which tools are exposed:\n\n```bash\n# Only expose read-only tools\n./fingerprint-mcp-server --read-only\n\n# Expose a specific set of tools\n./fingerprint-mcp-server --tools=get_event,search_events,list_environments\n```\n\nWhen `--tools` is set, it overrides `--read-only`.\n\n## Docker\n\n### Build the Image\n\n```bash\ndocker build -t fingerprint-mcp-server .\n```\n\n### Run with Stdio Transport\n\n```bash\ndocker run -i --rm \\\n -e FINGERPRINT_SERVER_API_KEY=your-secret-api-key \\\n fingerprint-mcp-server\n```\n\n### Run with Streamable HTTP Transport\n\n```bash\ndocker run -d --rm \\\n -e FINGERPRINT_SERVER_API_KEY=your-secret-api-key \\\n -e MCP_TRANSPORT=streamable-http \\\n -p 8080:8080 \\\n fingerprint-mcp-server\n```\n\n## MCP Client Configuration\n\n### Hosted endpoint (managed)\n\nThe quickest way to connect is the managed instance at `https://mcp.fpjs.io/mcp`, which runs in public mode and authenticates each user via OAuth2.\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=Fingerprint&config=eyJ1cmwiOiJodHRwczovL21jcC5mcGpzLmlvL21jcCIsInRyYW5zcG9ydCI6InN0cmVhbWFibGUtaHR0cCJ9)\n\n```json\n{\n \"mcpServers\": {\n \"fingerprint\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.fpjs.io/mcp\"\n }\n }\n}\n```\n\n### Self-hosted\n\nAdd to your Cursor/Claude Desktop/etc configuration file (e.g. `claude_desktop_config.json`):\n\n**Stdio Transport:**\n```json\n{\n \"mcpServers\": {\n \"fingerprint\": {\n \"command\": \"/path/to/fingerprint-mcp-server\",\n \"env\": {\n \"FINGERPRINT_SERVER_API_KEY\": \"your-secret-api-key\"\n }\n }\n }\n}\n```\n\n**Streamable HTTP Transport:**\n```json\n{\n \"mcpServers\": {\n \"fingerprint\": {\n \"url\": \"https://url/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer \"\n }\n }\n }\n}\n```\n\n**Docker with Stdio:**\n```json\n{\n \"mcpServers\": {\n \"fingerprint\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"FINGERPRINT_SERVER_API_KEY=your-secret-api-key\", \"fingerprint-mcp-server\"]\n }\n }\n}\n```\n\n## Available Tools\n\nEvent 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`.\n\n| Tool | Description |\n|----------------------|---------------------------------------------------------------------|\n| `get_event` | Retrieve a specific identification event by ID |\n| `search_events` | Search events with filters (visitor, IP, smart signals, time range) |\n| `list_environments` | List workspace environments with pagination |\n| `get_api_key` | Get details of a specific API key |\n| `list_api_keys` | List API keys with optional type/status/environment filters |\n| `create_environment` | Create a new workspace environment |\n| `update_environment` | Update an existing workspace environment |\n| `delete_environment` | Delete a workspace environment |\n| `create_api_key` | Create a new API key (public/secret/proxy) |\n| `update_api_key` | Update an existing API key |\n| `delete_api_key` | Delete an API key (irreversible) |\n\n## Available Resources\n\n- **`fingerprint://events/{event_id}`** — Returns full event data for a given event ID.\n- **`fingerprint://schemas/event`** — JSON Schema describing the event output structure.\n- **`fingerprint://schemas/environment`** — JSON Schema for environment objects.\n- **`fingerprint://schemas/api-key`** — JSON Schema for API key objects.\n\n## Available Prompts\n\n- **`onboarding`** — A guided walkthrough for integrating Fingerprint into a project, covering JavaScript Agent installation, API key setup, and verification steps.\n\n## License\n\nMIT\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_97":98,"_99":-5,"_100":101,"_102":103,"_104":105},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_95":82,"_96":82},"ratingAvg","reviewCount","topics",[],"license","language","Go","registryName","io.github.fingerprintjs/fingerprint-mcp-server","homepage","https://docs.fingerprint.com/docs/mcp-server","ENV",{"_108":109,"_110":111,"_112":113},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]