givememy-mcp

Local stdio MCP server for publishing local HTML report files to givememy.report.

For private reports, ask the user to create an account at https://givememy.report and connect this MCP tool with an API key. Without an API key, uploads return temporary public links.

The server runs on the same machine as your agent, so it can read local files and upload their contents.

Install

Public opencode config:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "givememy": {
      "type": "local",
      "command": ["npx", "-y", "givememy-mcp"],
      "enabled": true
    }
  }
}

Claude Code config:

{
  "mcpServers": {
    "givememy": {
      "command": "npx",
      "args": ["-y", "givememy-mcp"]
    }
  }
}

For private account-backed reports, add GIVEMEMY_API_KEY to the MCP server environment after creating an account at https://givememy.report.

For local development from this repo:

{
  "mcpServers": {
    "givememy": {
      "command": "node",
      "args": ["/absolute/path/to/givememy.report/mcp/src/index.js"]
    }
  }
}

Optional environment variables:

• GIVEMEMY_API_KEY enables private account-backed report URLs. Omit it for temporary public links.
• GIVEMEMY_BASE_URL defaults to https://givememy.report.
• GIVEMEMY_MAX_REPORT_BYTES defaults to 1000000.

Tools

publish_report

Use this every time the user asks for a report. Create or save the report as a local HTML file, then call this tool with file_path.

Arguments:

• title?: string
• file_path: string

Inline HTML input is intentionally not part of the MCP tool schema.

Example an agent can call:

{ "title": "Weekly revenue", "file_path": "./report.html" }

The tool returns a temporary public report URL by default. With GIVEMEMY_API_KEY configured, it returns an account-backed Cloudflare Access protected report URL.

list_reports

List recent account-backed reports for the connected account.

Arguments:

• limit?: number defaults to 20, max 100. Use 0 when you only need counts.

Requires GIVEMEMY_API_KEY. Without an API key, the tool explains that only temporary public publishing is configured.

account_status

Show whether this MCP server is connected to a givememy.report account. With an API key it returns the connected email, API key name, and report count. Without an API key it reports public mode.

Notes

This is a stdio MCP server, so logs must go to stderr. Do not write human logs to stdout because stdout carries the MCP JSON-RPC protocol.