PhilForms MCP server
Commit Nov 1, 2026Enables AI clients to search, fill, and verify official Philippine government forms like BIR, SSS, and PhilHealth via the PhilForms API.
Also known as philforms/philforms-mcp, philforms-mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 1, 2026
- License
- MIT
What is PhilForms MCP?
PhilForms enables AI clients to search, fill, and verify official Philippine government forms like BIR, SSS, and PhilHealth via the PhilForms API. It exposes 5 tools, such as search_forms, get_form_parameters, check_form_values.
Summary generated from the project's README
About PhilForms MCP server
PhilForms provides a bridge for AI clients like Claude or Cursor to interact with official Philippine government documentation. It connects to the PhilForms API to help users locate, complete, and validate forms from agencies such as BIR, SSS, PhilHealth, Pag-IBIG, CSC, GSIS, COA, and GPPB. The server maps every input directly to the printed boxes on the physical form, ensuring data like a TIN is placed precisely within the correct cells. If a value exceeds the capacity of a form field, the system rejects it with a specific reason rather than attempting to force the data.
Developers can set this up locally using npx or by downloading the mcpb file for Claude Desktop. An API key from philforms.com is required to function, with free test keys available that produce watermarked results. The server uses the PDFPHILE_API_KEY environment variable for authentication and saves completed documents to a local directory. It offers specific tools to search the catalogue, retrieve parameter contracts, check values before submission, fill forms to generate PDFs, and verify that a document remains unaltered via a tamper-evident ID.
What you can do with it
- 1Locate specific government documentsFind the correct form ID by searching for keywords like a specific BIR form number or a PhilHealth claim type.
- 2Validate data before printingEnsure all input values match the expected format and constraints of the official form before attempting to fill it.
- 3Generate completed PDF formsCreate a filled PDF document that includes a unique ID to prove the file has not been tampered with.
- 4Confirm document integrityVerify that a previously generated PDF has not been modified after the initial filling process.
Written from the project's README. Every use case is checked against a quote from it.
PhilForms MCP tools 5
Detected from the READMEsearch_formsget_form_parameterscheck_form_valuesfill_formverify_pdf
| search_forms | — | |
| get_form_parameters | — | |
| check_form_values | — | |
| fill_form | — | |
| verify_pdf | — |
Configuration
PDFPHILE_API_KEYRequiredSecretYour PhilForms API key (pk_test_… free and watermarked, or pk_live_…). Get one at https://philforms.com/account
PDFPHILE_OUT_DIRFolder for filled PDFs (default ./pdfphile-out)
| Name | Description | |
|---|---|---|
| PDFPHILE_API_KEY | Your PhilForms API key (pk_test_… free and watermarked, or pk_live_…). Get one at https://philforms.com/account | RequiredSecret |
| PDFPHILE_OUT_DIR | Folder for filled PDFs (default ./pdfphile-out) |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work
- Source repository linked and reachablephilforms/philforms-mcp is public and reachablegithub.com/philforms/philforms-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-01github.com/philforms/philforms-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPhilForms 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
| Tool | What it does |
|---|---|
search_forms |
Search the catalogue ("2307", "philhealth claim") → form ids |
get_form_parameters |
One form's fill contract: every parameter, label, type, format, choices |
check_form_values |
Check values before filling, each as it would print |
fill_form |
Fill a form → saved PDF path + tamper-evident document id |
verify_pdf |
Check 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.
PhilForms MCP questions
What tools does PhilForms MCP provide?
It exposes 5 tools, including search_forms, get_form_parameters, check_form_values, fill_form, verify_pdf.
What government agencies are supported?
The server supports forms from BIR, SSS, PhilHealth, Pag-IBIG, CSC, GSIS, COA, and GPPB.
Is this service affiliated with the Philippine government?
No, PhilForms is not affiliated with any government agency; it provides filling and printing services while the user is responsible for filing.
Where are the filled PDFs saved?
Filled PDFs are saved to the directory specified by the PDFPHILE_OUT_DIR environment variable, which defaults to ./pdfphile-out.