PhilForms MCP server

PhilForms MCP server

Lets Claude, Cursor or any MCP client find, fill and verify official Philippine government forms — BIR, SSS, PhilHealth, Pag-IBIG, CSC, GSIS, COA, GPPB — through the PhilForms API. Every input on every supported form is mapped to its printed box, so a TIN lands digit by digit in its cells, and values the form cannot hold are refused with the reason instead of being "fixed".

Not affiliated with BIR, SSS, PhilHealth, Pag-IBIG or any government agency. PhilForms fills and prints; you file.

Tools

Set up

Get an API key at philforms.com/account (pk_test_… is free and watermarked).

Claude Desktop: download philforms-mcp-1.0.0.mcpb and open it; it asks for the key.

Any MCP client:

{
  "mcpServers": {
    "philforms": {
      "command": "npx",
      "args": ["-y", "github:philforms/philforms-mcp"],
      "env": { "PDFPHILE_API_KEY": "pk_test_…" }
    }
  }
}

Filled PDFs go to PDFPHILE_OUT_DIR (default ./pdfphile-out). Requires Node 18+. No dependencies.

Listed in the official MCP registry as io.github.philforms/philforms-mcp.

API reference: philforms.com/developers · OpenAPI: https://philforms.com/api/v1/openapi.json

License

MIT — this repository holds only the MCP client. The PhilForms service itself is not open source.