Skip to main content

1) Install and prepare

git clone https://github.com/jayhickey/SafeFetch.git
cd SafeFetch/packages/server
npm install
cp .env.example .env
# edit .env — set DATABASE_URL and MCP_ACCOUNT_ID
npm run migrate
Required environment variables:
  • DATABASE_URL — your database connection string
  • MCP_ACCOUNT_ID
Optional:
  • PORT
  • RATE_LIMIT_PER_SECOND
  • DISPATCH_TIMEOUT_MS

2) Claude Desktop config

Add a server entry to Claude Desktop config.
{
  "mcpServers": {
    "safefetch": {
      "command": "npm",
      "args": ["run", "mcp"],
      "cwd": "/absolute/path/to/SafeFetch/packages/server",
      "env": {
        "DATABASE_URL": "<your-database-connection-url>",
        "MCP_ACCOUNT_ID": "acct_..."
      }
    }
  }
}

3) Test with Claude

Ask Claude to run a tool call, for example:
  • “Send an action that POSTs {\"ping\":true} to https://httpbin.org/post.”
  • “Check action act_... and summarize result.”
If tool calls fail immediately, verify MCP_ACCOUNT_ID belongs to an existing account row and that the database connection is reachable.