Skip to content
MCP server

Wafeq

Wafeq accounting API: all 251 endpoints as safety-categorized MCP tools, over stdio or…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.1.0
Listing updated
6 days ago

About Wafeq

Wafeq is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Wafeq accounting API: all 251 endpoints as safety-categorized MCP tools, over stdio or HTTP.

Install

Run in a terminal

claude mcp add wafeq-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env WAFEQ_API_KEY='<WAFEQ_API_KEY>' --env WAFEQ_ACCESS_TOKEN='<WAFEQ_ACCESS_TOKEN>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_TRANSPORT -e WAFEQ_API_KEY -e WAFEQ_ACCESS_TOKEN -e MCP_AUTH_TOKEN ghcr.io/ohneben/wafeq-mcp:2.1.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wafeq-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WAFEQ_API_KEY",
        "-e",
        "WAFEQ_ACCESS_TOKEN",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/wafeq-mcp:2.1.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WAFEQ_API_KEY": "<WAFEQ_API_KEY>",
        "WAFEQ_ACCESS_TOKEN": "<WAFEQ_ACCESS_TOKEN>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wafeq-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WAFEQ_API_KEY",
        "-e",
        "WAFEQ_ACCESS_TOKEN",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/wafeq-mcp:2.1.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WAFEQ_API_KEY": "<WAFEQ_API_KEY>",
        "WAFEQ_ACCESS_TOKEN": "<WAFEQ_ACCESS_TOKEN>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "wafeq-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WAFEQ_API_KEY",
        "-e",
        "WAFEQ_ACCESS_TOKEN",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/wafeq-mcp:2.1.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WAFEQ_API_KEY": "<WAFEQ_API_KEY>",
        "WAFEQ_ACCESS_TOKEN": "<WAFEQ_ACCESS_TOKEN>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wafeq-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WAFEQ_API_KEY",
        "-e",
        "WAFEQ_ACCESS_TOKEN",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/wafeq-mcp:2.1.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WAFEQ_API_KEY": "<WAFEQ_API_KEY>",
        "WAFEQ_ACCESS_TOKEN": "<WAFEQ_ACCESS_TOKEN>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wafeq-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "WAFEQ_API_KEY",
        "-e",
        "WAFEQ_ACCESS_TOKEN",
        "-e",
        "MCP_AUTH_TOKEN",
        "ghcr.io/ohneben/wafeq-mcp:2.1.0"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>",
        "WAFEQ_API_KEY": "<WAFEQ_API_KEY>",
        "WAFEQ_ACCESS_TOKEN": "<WAFEQ_ACCESS_TOKEN>",
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_TRANSPORTServer transport. Set to 'stdio' for local MCP clients; the image otherwise starts the Streamable HTTP transport.Required
  • WAFEQ_API_KEYPrivate organization API key, sent as `Authorization: Api-Key <key>`. Wafeq -> Settings -> Developer -> API keys. Required unless WAFEQ_ACCESS_TOKEN is set.
  • WAFEQ_ACCESS_TOKENOAuth2 app access token, sent as `Authorization: Bearer <token>`. Use instead of WAFEQ_API_KEY.
  • WAFEQ_TOOL_GROUPSComma-separated resource groups to expose, e.g. invoices,bills,reports. Empty exposes all 251 generated tools.
  • WAFEQ_API_BASE_URLOverrides the Wafeq API base URL. Defaults to https://api.wafeq.com/v1
  • MCP_AUTH_TOKENOnly for MCP_TRANSPORT=http: bearer token required on /mcp. Without it a non-loopback bind refuses to start.

Pricing

Open source

Wafeq FAQ

Is Wafeq free?

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

How do I add Wafeq to Claude Code?

Run this command in your terminal: claude mcp add wafeq-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env WAFEQ_API_KEY='<WAFEQ_API_KEY>' --env WAFEQ_ACCESS_TOKEN='<WAFEQ_ACCESS_TOKEN>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- docker run -i --rm -e MCP_TRANSPORT -e WAFEQ_API_KEY -e WAFEQ_ACCESS_TOKEN -e MCP_AUTH_TOKEN ghcr.io/ohneben/wafeq-mcp:2.1.0

Where this comes from

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

How AIPoweredBot checks servers