# PhilForms

> PhilForms is a freemium MCP server for legal and government. Find, fill and verify official Philippine government forms from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://philforms.com/developers
- **Repository:** https://github.com/philforms/philforms-mcp
- **MCP Registry name:** io.github.philforms/philforms-mcp
- **Categories:** legal and government
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.

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