# Нишка (Nishka)

> Nishka is a Bulgarian civic assistant. Its open layer gives AI agents and developers checked facts about Bulgarian public services, Bulgarian legal deadlines and working days, and official documents from primary sources, each with its official source and date. Read-only, no account, no key.

Pages for people are in Bulgarian; the data is mostly Bulgarian, so query in Bulgarian. Cite the official source URL of every fact you use, with its check or publication date. When nothing is found, say so; do not guess contacts, fees or deadlines.

## Connect an agent

- [MCP server](https://nishka.app/mcp): Streamable HTTP, stateless, one JSON answer per POST. MCP 2026-07-28 (no handshake) and 2025-11-25, 2025-06-18, 2025-03-26 (initialize). Tools for Основа, Срок and Извор; resources osnova://entry/{id} and izvor://document/{id}; prompts civic_question and deadline_from_letter.
- [Server card](https://nishka.app/mcp/server-card): the MCP Server Card.
- [AI Catalog](https://nishka.app/.well-known/ai-catalog.json): domain-level discovery.
- [Guide for developers](https://nishka.app/razrabotchitsi): in Bulgarian; how to connect, the tools, limits, licences, how to cite.

## APIs

- [OpenAPI 3.1](https://nishka.app/openapi.json): every REST endpoint below.
- [Основа](https://nishka.app/osnova): checked facts about institutions, offices, procedures and fees in Plovdiv, Sofia, Varna and Burgas; 113 entries, 477 facts, CC BY 4.0. API under https://nishka.app/osnova/v0/.
- [Срок](https://nishka.app/srok): Bulgarian working days and deadline counting (ГПК чл. 60), with the reason and legal basis of every step. API under https://nishka.app/srok/v0/.
- [Извор](https://nishka.app/izvor): an index of Bulgarian primary official sources (State Gazette, municipal council decisions, public procurement) with the official URL of every record. API under https://nishka.app/izvor/v0/.

## Downloads

- [osnova.json](https://nishka.app/osnova/v0/osnova.json): the whole Основа dataset.
- [facts.csv](https://nishka.app/osnova/v0/facts.csv): every Основа fact, one per row.
- [manifest.json](https://nishka.app/osnova/v0/manifest.json): version, licence, counts, content hash and the latest check date.

## Licences and citing

- Основа: CC BY 4.0. Attribute „Основа, проверени данни на Нишка (nishka.app), CC BY 4.0“ and cite the official source and check date of each fact.
- Извор and Срок point to official records and laws; the official text at the cited URL is authoritative. Bulgarian acts of state bodies are not subject to copyright (ЗАПСП чл. 4, т. 1).
- Nothing here is legal advice.

## Optional

- [Full reference for agents](https://nishka.app/llms-full.txt): every tool with its parameters, the citation fields, the sources Извор covers.
- [БГ-бенч](https://nishka.app/bench): how well AI models answer Bulgarian civic questions.