Skip to content
MCP server

Gocertius

MCP server for GoCertius: certified evidence, dossiers, notifications and chats via AI…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.0.0
Listing updated
today

About Gocertius

Gocertius is an open-source MCP server. It runs locally on your machine and is started by your AI client.

MCP server for GoCertius: certified evidence, dossiers, notifications and chats via AI agents.

Install

Run in a terminal

claude mcp add gocertius --env MCP_API_BASE_URL='<MCP_API_BASE_URL>' --env MCP_AUTH_USER_KEY='<MCP_AUTH_USER_KEY>' --env MCP_SVC_CLIENT_SECRET='<MCP_SVC_CLIENT_SECRET>' -- npx -y @g-digital/mcp-gocertius

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gocertius": {
      "command": "npx",
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "env": {
        "MCP_API_BASE_URL": "<MCP_API_BASE_URL>",
        "MCP_AUTH_USER_KEY": "<MCP_AUTH_USER_KEY>",
        "MCP_SVC_CLIENT_SECRET": "<MCP_SVC_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gocertius": {
      "command": "npx",
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "env": {
        "MCP_API_BASE_URL": "<MCP_API_BASE_URL>",
        "MCP_AUTH_USER_KEY": "<MCP_AUTH_USER_KEY>",
        "MCP_SVC_CLIENT_SECRET": "<MCP_SVC_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gocertius": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "env": {
        "MCP_API_BASE_URL": "<MCP_API_BASE_URL>",
        "MCP_AUTH_USER_KEY": "<MCP_AUTH_USER_KEY>",
        "MCP_SVC_CLIENT_SECRET": "<MCP_SVC_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gocertius": {
      "command": "npx",
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "env": {
        "MCP_API_BASE_URL": "<MCP_API_BASE_URL>",
        "MCP_AUTH_USER_KEY": "<MCP_AUTH_USER_KEY>",
        "MCP_SVC_CLIENT_SECRET": "<MCP_SVC_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gocertius": {
      "command": "npx",
      "args": [
        "-y",
        "@g-digital/mcp-gocertius"
      ],
      "env": {
        "MCP_API_BASE_URL": "<MCP_API_BASE_URL>",
        "MCP_AUTH_USER_KEY": "<MCP_AUTH_USER_KEY>",
        "MCP_SVC_CLIENT_SECRET": "<MCP_SVC_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_ALLOW_INSECURE_FILE_URLSet to "true" to allow plain http:// fileUrl downloads in evidence_create (default https-only). Private/internal addresses are rejected regardless (resolution-time check; see the documented DNS TOCTOU limitation in the hosted-deployment runbook).
  • MCP_ALLOW_UNVERIFIED_BEAREREscape hatch for MCP_HTTP_PUBLIC=true WITHOUT inbound-token introspection: set to "true" ONLY when an upstream gateway already verifies Bearer tokens. The server logs a prominent warning and forwards tokens upstream unverified.
  • MCP_ALLOWED_HOSTSComma-separated allowed Host headers. Empty = Host validation disabled (default). When set, requests with a Host outside the list are rejected.
  • MCP_ALLOWED_ORIGINSComma-separated allowed browser Origins (DNS-rebinding defense). Empty = reject any request carrying an Origin header; non-browser clients (CLI/SDK) send no Origin and are always allowed. Use '*' to allow all.
  • MCP_API_BASE_URLUpstream API root. Required: your user key is exchanged for a session token against this host, and the server will not start without it.Required
  • MCP_AUTH_USER_KEYLong-lived GoCertius user key, exchanged automatically for a short-lived session token. Use it for headless or automated access instead of an account password. (See https://www.gocertius.io for credential acquisition.)Required
  • MCP_HTTP_HOSTInterface the HTTP transport binds to. Default 127.0.0.1 (localhost only). Set 0.0.0.0 to expose on all interfaces (containers do this automatically).
  • MCP_HTTP_MAX_BODY_BYTESMaximum accepted POST /mcp request-body size in bytes (default 16777216 = 16 MiB — sized so base64 file uploads within the documented tool limits fit). Oversized requests get a 413 JSON-RPC error before/while reading — closes a memory-exhaustion DoS vector in public deployments. Note: base64 file sources are capped by this limit BEFORE MCP_FILE_MAX_BYTES applies.
  • MCP_HTTP_PUBLICSet to "true" for public/multi-tenant deployments. Activates Host validation and refuses to start unless (1) MCP_ALLOWED_ORIGINS or MCP_ALLOWED_HOSTS is set AND (2) inbound Bearer introspection is configured (MCP_SVC_INTROSPECT_URL + MCP_SVC_CLIENT_ID/SECRET) or MCP_ALLOW_UNVERIFIED_BEARER=true is set explicitly (fail-closed).
  • MCP_SVC_CLIENT_IDClient ID this server presents to the introspection endpoint above (its resource-server credentials). Only needed alongside MCP_SVC_INTROSPECT_URL; it does not authenticate you to GoCertius.
  • MCP_SVC_CLIENT_SECRETClient secret this server presents to the introspection endpoint above (its resource-server credentials). Only needed alongside MCP_SVC_INTROSPECT_URL; it does not authenticate you to GoCertius. (See https://www.gocertius.io for credential acquisition.)
  • MCP_SVC_INTROSPECT_URLRFC 7662 token introspection URL for inbound Bearer verification in HTTP mode. Opt-in, and required when MCP_HTTP_PUBLIC=true. Leave empty for stdio (local) use.
  • PORTHTTP port when running in hosted (HTTP) mode; ignored in stdio mode

Pricing

Open source

Gocertius FAQ

Is Gocertius free?

Yes. Gocertius is open source, so you can use and self-host it for free.

How do I add Gocertius to Claude Code?

Run this command in your terminal: claude mcp add gocertius --env MCP_API_BASE_URL='<MCP_API_BASE_URL>' --env MCP_AUTH_USER_KEY='<MCP_AUTH_USER_KEY>' --env MCP_SVC_CLIENT_SECRET='<MCP_SVC_CLIENT_SECRET>' -- npx -y @g-digital/mcp-gocertius

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers