Skip to main content
BIR Issuancesby BetterGov.phBeta
Official source

Model Context Protocol

BIR issuance research, inside your AI.

Connect Codex, Claude, Cursor, VS Code, or any MCP-capable client to search, browse, and retrieve source-linked Philippine revenue issuances from the conversation. Public beta access is free and requires no API key.

TransportStreamable HTTPStateless JSON-RPC over POST
Tools3 focused toolsSearch, list, and retrieve

Server URL

Connect through BetterGov.ph.

The custom domain is the canonical public MCP endpoint.
Live now

BetterGov.ph

https://bir.bettergov.ph/api/mcp

Client setup

Add it to your research workflow

Most MCP clients need one command or a small configuration entry.

OpenAI Codex

Add to ~/.codex/config.toml.

[mcp_servers.bir-issuances]
url = "https://bir.bettergov.ph/api/mcp"

Claude Code

Run once in your terminal.

claude mcp add --transport http bir-issuances https://bir.bettergov.ph/api/mcp

Claude.ai & Claude Desktop

Add a public custom connector.

  1. Open Settings → Connectors.
  2. Select Add custom connector.
  3. Name it BIR Issuances and paste the live server URL.

Cursor

Add to .cursor/mcp.json or ~/.cursor/mcp.json.

{
  "mcpServers": {
    "bir-issuances": { "url": "https://bir.bettergov.ph/api/mcp" }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json.

{
  "servers": {
    "bir-issuances": {
      "type": "http",
      "url": "https://bir.bettergov.ph/api/mcp"
    }
  }
}

Other MCP clients

Use any client that supports Streamable HTTP.

npx -y mcp-remote https://bir.bettergov.ph/api/mcp

Use the bridge only for stdio-only clients. The server itself needs no session or credentials.

Available tools

Three tools, one source-linked index

The same Qdrant collection and search path power the public site and JSON API.

search_issuances

Search by natural-language topic, document number, or phrase. Filter by issuance type or analysis topic, then order by relevance or year.

list_issuances

Browse the full index with type and analysis-topic filters, newest/oldest ordering, and cursor-based pagination.

get_issuance

Retrieve one issuance by canonical slug, with its indexed text, source URL, and research metadata.

Try asking

  • Find BIR issuances about VAT on digital services.
  • List the latest indexed Revenue Regulations and preserve their source links.
  • Get RMC 44-2024 and summarize the obligations in plain language.
  • Search for expanded withholding tax guidance, then retrieve the most relevant issuance.

Protocol reference

Open, stateless, and easy to inspect

GET returns a discovery document. POST accepts JSON-RPC 2.0 MCP messages; OPTIONS supports browser clients.
Initialize
curl -X POST "https://bir.bettergov.ph/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0"}}}'
Call search_issuances
curl -X POST "https://bir.bettergov.ph/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_issuances","arguments":{"query":"expanded withholding tax","kind":"rmc","limit":5}}}'
Supported protocol versions2025-06-18 · 2025-03-26 · 2024-11-05

This is an independent research service, not an official BIR endpoint. Tool results include source links; verify consequential tax and legal claims against the original BIR document.