ghostfolio-mcp

Ghostfolio MCP

MCP server for Ghostfolio portfolio management and financial data access

communityservice

Package Details

ghostfolio-mcp

1.2.0•https://pypi.org/project/ghostfolio-mcp

Transportstdio

Runtimeuvx

Environment Variables

GHOSTFOLIO_URL

Required

Ghostfolio base URL (e.g., https://domain.tld:3333)

GHOSTFOLIO_TOKEN

RequiredSecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Default:true

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Default:30

Request timeout in seconds

READ_ONLY_MODE

Default:false

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

Default:INFO

Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)

RATE_LIMIT_ENABLED

Default:false

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Default:60

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Default:1

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Default:false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Default:bm25

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Default:5

Maximum tool search results returned by search_tools

ghostfolio-mcp

1.2.0•https://pypi.org/project/ghostfolio-mcp

TransportStreamable HTTP

Runtimeuvx

Environment Variables

GHOSTFOLIO_URL

Required

Ghostfolio base URL (e.g., https://domain.tld:3333)

GHOSTFOLIO_TOKEN

RequiredSecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Default:true

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Default:30

Request timeout in seconds

READ_ONLY_MODE

Default:false

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

Default:INFO

Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)

RATE_LIMIT_ENABLED

Default:false

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Default:60

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Default:1

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Default:false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Default:bm25

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Default:5

Maximum tool search results returned by search_tools

MCP_HTTP_PORT

Default:8000

Port for HTTP server (default: 8000)

MCP_TRANSPORT

MCP transport type (http for HTTP, stdio for stdio)

ghcr.io/mhajder/ghostfolio-mcp:1.2.0

https://github.com/mhajder/ghostfolio-mcp/pkgs/container/ghostfolio-mcp

TransportStreamable HTTP

Runtime Arguments

Named

-pRequired

{MCP_HTTP_PORT}:8000Port mapping for HTTP transport

Environment Variables

GHOSTFOLIO_URL

Required

Ghostfolio base URL (e.g., https://domain.tld:3333)

GHOSTFOLIO_TOKEN

RequiredSecret

Ghostfolio API token for authentication

GHOSTFOLIO_VERIFY_SSL

Default:true

Verify SSL certificates (true/false)

GHOSTFOLIO_TIMEOUT

Default:30

Request timeout in seconds

READ_ONLY_MODE

Default:false

Enable read-only mode to restrict write operations

GHOSTFOLIO_DISABLED_TAGS

Comma-separated list of tags to disable tools for

LOG_LEVEL

Default:INFO

Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)

RATE_LIMIT_ENABLED

Default:false

Enable rate limiting

RATE_LIMIT_MAX_REQUESTS

Default:60

Maximum requests per rate limit window

RATE_LIMIT_WINDOW_MINUTES

Default:1

Rate limit window in minutes

TOOL_SEARCH_ENABLED

Default:false

Enable FastMCP tool search transform

TOOL_SEARCH_STRATEGY

Default:bm25

Tool search strategy (bm25 or regex)

TOOL_SEARCH_MAX_RESULTS

Default:5

Maximum tool search results returned by search_tools

MCP_HTTP_PORT

Default:8000

Port for HTTP server (default: 8000)