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:

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