Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "mcp-firefly-iii": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/[email protected]"
      ],
      "env": {
        "FIREFLY_API_URL": "${FIREFLY_API_URL}",
        "FIREFLY_API_TOKEN": "${FIREFLY_API_TOKEN}"
      }
    }
  }
}

claude mcp add mcp-firefly-iii -e "FIREFLY_API_URL=${FIREFLY_API_URL}" -e "FIREFLY_API_TOKEN=${FIREFLY_API_TOKEN}" -- npx -y @yakupemreyerli/[email protected]

[mcp_servers.mcp-firefly-iii]
command = "npx"
args = ["-y", "@yakupemreyerli/[email protected]"]
env = { "FIREFLY_API_URL" = "${FIREFLY_API_URL}", "FIREFLY_API_TOKEN" = "${FIREFLY_API_TOKEN}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp-firefly-iii": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@yakupemreyerli/[email protected]"
      ],
      "enabled": true,
      "environment": {
        "FIREFLY_API_URL": "{env:FIREFLY_API_URL}",
        "FIREFLY_API_TOKEN": "{env:FIREFLY_API_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-firefly-iii": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/[email protected]"
      ],
      "env": {
        "FIREFLY_API_URL": "${FIREFLY_API_URL}",
        "FIREFLY_API_TOKEN": "${FIREFLY_API_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=mcp-firefly-iii&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB5YWt1cGVtcmV5ZXJsaS9maXJlZmx5LW1jcEAxLjEuMiJdLCJlbnYiOnsiRklSRUZMWV9BUElfVVJMIjoiJHtGSVJFRkxZX0FQSV9VUkx9IiwiRklSRUZMWV9BUElfVE9LRU4iOiIke0ZJUkVGTFlfQVBJX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "mcp-firefly-iii": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/[email protected]"
      ],
      "env": {
        "FIREFLY_API_URL": "${FIREFLY_API_URL}",
        "FIREFLY_API_TOKEN": "${FIREFLY_API_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-firefly-iii": {
      "command": "npx",
      "args": [
        "-y",
        "@yakupemreyerli/[email protected]"
      ],
      "env": {
        "FIREFLY_API_URL": "${FIREFLY_API_URL}",
        "FIREFLY_API_TOKEN": "${FIREFLY_API_TOKEN}"
      }
    }
  }
}

extensions:
  "mcp-firefly-iii":
    enabled: true
    name: "mcp-firefly-iii"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "@yakupemreyerli/[email protected]"
    envs:
      "FIREFLY_API_URL": "${FIREFLY_API_URL}"
      "FIREFLY_API_TOKEN": "${FIREFLY_API_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${FIREFLY_API_TOKEN}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies50 · weight 15

warn
deps.known_vulns1 advisory of lower severity or without a published fix: GHSA-5r4p-p66f-jhc7 in [email protected] (indirect, fixed in 4.13.11)
fail
deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 3 known advisories (GHSA-22jm-h49p-29qw, GHSA-6prh-2h8m-c8cw, GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.32.0 or later
pass
deps.resolvable@yakupemreyerli/[email protected] resolved: 99 packages

Tool list unknown · checked 2026-10-20 21:51 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 87 / 100

provenance80

livenessn/a

freshness85

hygiene100

+repository +namespace-matches-repo ~liveness-unmeasured ~updated-51d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@yakupemreyerli/[email protected] npm98 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-20

advisory	severity	package	fixed in
GHSA-22jm-h49p-29qwMCP TypeScript SDK: Experimental tasks were not tied to the session that created them	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.32.0`
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.31.0`
GHSA-6prh-2h8m-c8cwMCP TypeScript client SDK: HTTP client transports and OAuth requests followed cross-origin redirects and re-sent custom headers and request bodies	moderate	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.32.0`
GHSA-5r4p-p66f-jhc7Hono: `serveStatic` decodes the request path a second time, leading to bypass of middleware on static paths	moderate	`[email protected]`indirect	fixed in `4.13.11`

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`@yakupemreyerli/firefly-mcp`	npm	1.1.2	–	`FIREFLY_API_TOKEN`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.YakupEmreYerli/mcp-firefly-iii",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.1.2",
  "packages": [
    {
      "version": "1.1.2",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@yakupemreyerli/firefly-mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "FIREFLY_API_URL",
          "format": "string",
          "isRequired": true,
          "description": "Your Firefly III instance URL (a bare domain, or a full base URL including /api/v1)"
        },
        {
          "name": "FIREFLY_API_TOKEN",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "Firefly III Personal Access Token (Options → Profile → OAuth → Create New Personal Access Token)"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/YakupEmreYerli/mcp-firefly-iii",
    "source": "github"
  },
  "description": "Security-first, self-hosted MCP server for Firefly III — 152 operations behind 5 scoped tools."
}