Skip to content
MCP server

PhilForms

Find, fill and verify official Philippine government forms from an AI client

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
1.0.0
Listing updated
2 days ago

About PhilForms

PhilForms is a freemium MCP server for legal and government. It runs locally on your machine and is started by your AI client.

PhilForms maps every input on each supported form to its printed box, so a TIN lands digit by digit in its cells. Values a form cannot hold are refused with the reason rather than quietly altered. Supported agencies include BIR, SSS, PhilHealth, Pag-IBIG, CSC, GSIS, COA and GPPB, and the developer page cites 1,402 forms. PhilForms fills and prints; you file, and it states it is not affiliated with any government agency.

A typical flow is to search the catalogue for a form id, fetch its parameter contract, check values as they would print, then fill. Fill returns a saved PDF path and a tamper-evident document id, and a separate tool confirms a PDF is unaltered. Output goes to a folder set by PDFPHILE_OUT_DIR.

The MCP client is MIT-licensed and needs Node 18 or newer, but the PhilForms service behind it is not open source and requires an API key. A pk_test key is free and watermarked. Paid pricing is in pesos: Starter is 99 pesos a month for three months then 299, Pro is 1,999, and Government is quoted.

Install

Run in a terminal

claude mcp add philforms-mcp --env PDFPHILE_API_KEY='<PDFPHILE_API_KEY>' -- npx -y https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "philforms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb"
      ],
      "env": {
        "PDFPHILE_API_KEY": "<PDFPHILE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "philforms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb"
      ],
      "env": {
        "PDFPHILE_API_KEY": "<PDFPHILE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "philforms-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb"
      ],
      "env": {
        "PDFPHILE_API_KEY": "<PDFPHILE_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "philforms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb"
      ],
      "env": {
        "PDFPHILE_API_KEY": "<PDFPHILE_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "philforms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb"
      ],
      "env": {
        "PDFPHILE_API_KEY": "<PDFPHILE_API_KEY>"
      }
    }
  }
}

Configuration

  • PDFPHILE_API_KEYYour PhilForms API key (pk_test_… free and watermarked, or pk_live_…). Get one at https://philforms.com/accountRequired
  • PDFPHILE_OUT_DIRFolder for filled PDFs (default ./pdfphile-out)

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

search_forms
Searches the form catalogue and returns form ids.
get_form_parameters
Returns one form's parameters, labels, types and choices.
check_form_values
Checks values before filling, shown as they would print.
fill_form
Fills a form and returns a saved PDF path and document id.
verify_pdf
Checks that a filled PDF is unaltered.

What it does

Form catalogue search
Search by number or name, such as 2307 or PhilHealth claim.
Typed fill contract
Each form lists parameters, labels, formats and choices.
Pre-fill checks
See values as they would print before generating a PDF.
Tamper-evident output
Filled PDFs carry a document id for later verification.
Strict validation
Values a form cannot hold are refused with the reason.
Desktop bundle
An .mcpb file installs it in Claude Desktop.

Good for

  • Prepare a BIR 2307 certificate for a supplier
  • Fill an SSS or PhilHealth form from structured data
  • Check that a filled PDF has not been altered
  • Look up which form a Philippine process needs

Pricing

Freemium

Free watermarked test key; Starter 99 pesos/month for 3 months then 299; Pro 1,999 pesos; prices in PHP

Prices change. Check philforms.com before you buy.

PhilForms FAQ

Do I need an API key?

Yes. A pk_test key is free and produces watermarked PDFs; get one at philforms.com/account.

Does it file forms for me?

No. PhilForms fills and prints; you file.

What does a paid plan cost?

Starter is 99 pesos a month for three months, then 299; Pro is 1,999; Government is quoted.

What are the requirements?

Node 18 or newer; the repository has no dependencies.

Is PhilForms free?

PhilForms has a free plan, with paid plans for more usage or features.

How do I add PhilForms to Claude Code?

Run this command in your terminal: claude mcp add philforms-mcp --env PDFPHILE_API_KEY='<PDFPHILE_API_KEY>' -- npx -y https://github.com/philforms/philforms-mcp/releases/download/v1.0.0/philforms-mcp-1.0.0.mcpb

What are the best alternatives to PhilForms?

The closest alternatives to PhilForms are NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog, SynomosAI Governance MCP and MedXpert 标准检索连接器.

Alternatives to PhilForms

  1. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  2. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government
  3. Russian statutes, Supreme Court guidance and court practice for AI assistants

    • 3 tools
    • Remote
    • Free
    • Legal and government
  4. Self-assess AI agent governance: A3 scorecard, ISO 42001 evidence and PII scan

    Runs locally
    • 6 tools
    • Open source
    • Security
  5. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  6. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents