# ihalent

ihalent is a Claude Code MCP server that structures Turkish public tender results from EKAP. Processes Kamu İhale Bülteni daily records to extract contractor histories and discount margins.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: gulmezeren2-byte
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gulmezeren2-byte/ihalent
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ihalent

## What it does

The server parses Turkish government contract award notices into structured `JSONL` datasets. It computes how far winning bids fall below initial project valuations, compiles win totals, and tracks tenders where only one vendor showed up.

Contractor names are unified across minor spelling variations. When an agency omits an official project estimate, the discount value resolves to `None` rather than zero, preventing distorted averages in downstream calculations.

Running the tool and reading bulletin PDFs requires Python 3.10+ alongside package extras like `ihalent[mcp]` or `ihalent[bulletin]`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ihalent -- uvx ihalent
```
uvx runs the command named after the package; if the README names another one, use uvx --from ihalent <command>

### Codex

**Platform CLI**
```bash
codex mcp add ihalent -- uvx ihalent
```
uvx runs the command named after the package; if the README names another one, use uvx --from ihalent <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ihalent": {
            "command": "uvx",
            "args": [
                "ihalent"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ihalent <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ihalent": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ihalent"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ihalent <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ihalent uvx ihalent
```
uvx runs the command named after the package; if the README names another one, use uvx --from ihalent <command>

## When to use it
- convert Kamu İhale Bülteni public notices into structured JSONL
- calculate mean discount percentages across specific contracting authorities
- compile vendor contract awards while grouping name variations
- identify emergency awards that exceeded government estimates

## Example prompts
- Analyze `awards.jsonl` and show the award history for contractor ÖZDEN YEL
- Calculate the mean discount percentage grouped by procuring authority from `awards.jsonl`
- Scan `awards.jsonl` for single-bidder procurement notices

## Similar
- [Tender MCP](https://affpapa.org/en/nevibecode/mcp/tender-mcp.md) — MCP server · 339 installs
- [simap-mcp](https://affpapa.org/en/nevibecode/mcp/simap-mcp.md) — MCP server · ★ 10 repo stars
- [Lentra](https://affpapa.org/en/nevibecode/mcp/lentra.md) — MCP server
- [workspaceAlberta](https://affpapa.org/en/nevibecode/mcp/workspacealberta.md) — MCP server
- [Diavgis — Greek Public Procurement](https://affpapa.org/en/nevibecode/mcp/diavgis-greek-public-procurement.md) — MCP server
- [Swiss company data](https://affpapa.org/en/nevibecode/mcp/swiss-company-data.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
