English Français العربية

PhilForms

Official registry Government and legal

Find, fill and verify official Philippine government forms: BIR, SSS, PhilHealth, Pag-IBIG, CSC.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb

Environment variables

  • PDFPHILE_API_KEY required secret Your PhilForms API key (pk_test_… free and watermarked, or pk_live_…). Get one at https://philforms.com/account
  • PDFPHILE_OUT_DIR Folder for filled PDFs (default ./pdfphile-out)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PhilForms MCP server
  2. Tools
  3. Set up
  4. License

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 1,342 forms 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

ToolWhat it does
search_formsSearch the catalogue ("2307", "philhealth claim") → form ids
get_form_parametersOne form's fill contract: every parameter, label, type, format, choices
check_form_valuesCheck values before filling, each as it would print
fill_formFill a form → saved PDF path + tamper-evident document id
verify_pdfCheck that a filled PDF is unaltered

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.

Frequently asked questions

What is PhilForms?

Find, fill and verify official Philippine government forms: BIR, SSS, PhilHealth, Pag-IBIG, CSC.

How do I install PhilForms?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does PhilForms need an API key?

Yes. It expects PDFPHILE_API_KEY, which you set in its configuration.

Is PhilForms open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PhilForms?

It is published by philforms. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.