Skip to content
← Projects

04 / Source access

GİB MCP · tax legislation search

An MCP server that lets AI assistants search rulings and legislation from the Turkish Revenue Administration portal.

Open source · Updated · October 2026

My contribution

Turning portal search, filters and full-text retrieval into MCP tools.

The problem

Checking an answer requires moving from a search result to the full text of the relevant source.

My decisions

  1. Keep general search, ruling search and detail retrieval as separate tools.

  2. Narrow searches by law, article and date.

  3. Support windowed access to long texts and local or HTTP operation.

Working result

The Python package, MCP tools and tests are public. The README documents installation and connection steps.

An independent project, not an official GİB product. Changes to the undocumented portal API can affect retrieval. Check the source text rather than treating generated output as legal or tax advice.

Evidence & sources

Read-only public source inspection · 2026-10-02
GET https://api.github.com/repos/mahsumaktas/gib-ozelge-mcp/git/trees/main?recursive=1
Selected response fields (JSON):
{
  "repository": "mahsumaktas/gib-ozelge-mcp",
  "revision": "bf4deeea28f7f6abed35cea22d959f719933e595",
  "public_source_paths": [
    "pyproject.toml",
    "src/gib_ozelge_mcp",
    "tests"
  ]
}
2 October 2026: read-only inspection of public files. This is source evidence, not an application run or performance test. Text record ↗

Python / MCP / HTTP / GİB portal