FastMCP Tools

A curated collection of reusable MCP tools for fastmcp-server. Each tool is a standalone Python file ready to deploy via inline ConfigMap, S3, or Git source.

Source: helmforgedev/fastmcp-tools

Kubernetes

Tool	Description	Dependencies
`get_pods`	List pods in a namespace with status and restart counts	`kubernetes`
`get_logs`	Get pod logs with container and tail options	`kubernetes`
`describe_resource`	Get detailed info about pods, services, deployments, configmaps, secrets	`kubernetes`

sources:
  git:
    enabled: true
    repository: 'https://github.com/helmforgedev/fastmcp-tools.git'
    branch: main
    path: tools/kubernetes
extraPipPackages:
  - kubernetes

GitHub

Tool	Description	Dependencies
`list_issues`	List issues with state/label filtering (cached 60s)	`requests`
`create_pr`	Create pull requests	`requests`
`get_file`	Get file contents from a repository (cached 120s)	`requests`

Requires GITHUB_TOKEN env var for private repos and write operations.

sources:
  git:
    enabled: true
    repository: 'https://github.com/helmforgedev/fastmcp-tools.git'
    branch: main
    path: tools/github
extraPipPackages:
  - requests
extraEnv:
  - name: GITHUB_TOKEN
    valueFrom:
      secretKeyRef:
        name: github-token
        key: token

HTTP

Tool	Description	Dependencies
`fetch_url`	Fetch content from any URL (GET/POST/etc) with custom headers	`requests`
`post_json`	POST JSON data to a URL	`requests`

sources:
  git:
    enabled: true
    repository: 'https://github.com/helmforgedev/fastmcp-tools.git'
    branch: main
    path: tools/http
extraPipPackages:
  - requests

Database

Tool	Description	Dependencies
`query_postgres`	Execute read-only SQL on PostgreSQL (rate limited 30/min)	`psycopg2-binary`
`query_mysql`	Execute read-only SQL on MySQL (rate limited 30/min)	`pymysql`

Both tools enforce read-only mode — only SELECT and WITH queries are allowed.

sources:
  git:
    enabled: true
    repository: 'https://github.com/helmforgedev/fastmcp-tools.git'
    branch: main
    path: tools/database
extraPipPackages:
  - psycopg2-binary
  - pymysql
extraEnv:
  - name: DATABASE_URL
    valueFrom:
      secretKeyRef:
        name: db-credentials
        key: url

Notifications

Tool	Description	Dependencies
`send_slack`	Send messages via Slack webhook (rate limited 10/min)	`requests`
`send_email`	Send email via SMTP (rate limited 5/min)	stdlib only

sources:
  git:
    enabled: true
    repository: 'https://github.com/helmforgedev/fastmcp-tools.git'
    branch: main
    path: tools/notifications
extraPipPackages:
  - requests
extraEnv:
  - name: SLACK_WEBHOOK_URL
    valueFrom:
      secretKeyRef:
        name: slack-config
        key: webhook-url

Tool Metadata

All tools use fastmcp-server module-level magic variables for enhanced behavior:

Variable	Example	Description
`__tags__`	`["kubernetes", "read"]`	Tool categorization for visibility control
`__timeout__`	`30.0`	Execution timeout in seconds
`__rate_limit__`	`"30/min"`	Rate limiting
`__cache_ttl__`	`60`	Result caching TTL in seconds
`__max_output_size_kb__`	`500`	Output truncation limit

Contributing

Tools should follow these conventions:

One file per tool function
Clear docstring explaining what the tool does
Type annotations on all parameters
Environment variable fallbacks for credentials
Appropriate __tags__, __timeout__, and rate limits
Read-only by default for data access tools