MCP Setup - SafeFetch

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_..."
      }
    }
  }
}

{
  "mcpServers": {
    "safefetch": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "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.