# Halowerk MCP

> Halowerk MCP is an open-source MCP server. 134 paid APIs as MCP tools, billed per call in USDC on Base. No account, no login. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/halowerk/halowerk-mcp
- **MCP Registry name:** io.github.halowerk/halowerk-mcp
- **Listing updated:** 2026-11-13

## About

134 paid APIs as MCP tools, billed per call in USDC on Base. No account, no login.

## Install

### Claude Code (Terminal)

```sh
claude mcp add halowerk-mcp --env HALOWERK_PRIVATE_KEY='<HALOWERK_PRIVATE_KEY>' -- npx -y halowerk-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "halowerk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "halowerk-mcp"
      ],
      "env": {
        "HALOWERK_PRIVATE_KEY": "<HALOWERK_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "halowerk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "halowerk-mcp"
      ],
      "env": {
        "HALOWERK_PRIVATE_KEY": "<HALOWERK_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "halowerk-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "halowerk-mcp"
      ],
      "env": {
        "HALOWERK_PRIVATE_KEY": "<HALOWERK_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "halowerk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "halowerk-mcp"
      ],
      "env": {
        "HALOWERK_PRIVATE_KEY": "<HALOWERK_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "halowerk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "halowerk-mcp"
      ],
      "env": {
        "HALOWERK_PRIVATE_KEY": "<HALOWERK_PRIVATE_KEY>"
      }
    }
  }
}
```

## FAQ

### Is Halowerk MCP free?

Yes. Halowerk MCP is open source, so you can use and self-host it for free.

### How do I add Halowerk MCP to Claude Code?

Run this command in your terminal: claude mcp add halowerk-mcp --env HALOWERK_PRIVATE_KEY='<HALOWERK_PRIVATE_KEY>' -- npx -y halowerk-mcp

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/halowerk-mcp
