Что такое MCP сервер?
Model Context Protocol (MCP) — открытый протокол, который позволяет IDE, боту или ИИ агенту подключать «инструменты» и ресурсы внешних систем по единому контракту. Наш MCP сервер даёт вашему приложению удобный, безопасный и предсказуемый доступ к данным TenderGuru.
- JSON RPC 2.0: initialize, tools/list, tools/call.
- Готовые инструменты: поиск и детали тендеров РФ, мира, контракты, документации, контрагенты по ИНН, торги.
- Удобные HTTP ручки для отладки и интеграций без JSON RPC.
Доступ к информации TenderGuru.ru через нейросети
Встраивайте нашу информации в ваши приложения.
Пример JSON RPC запроса
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {"protocolVersion": "2025-06-18"}
}
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "ru.search",
"arguments": { "query": "кирпич шамотный !услуги", "regions": [50], "page": 0 }
}
}
Возможности
Тендеры РФ
Поиск и детали по id. Тендеры по 44-ФЗ и 223-ФЗ по номеру: изменения (mode=izm) и победитель (mode=contract).
- ru.search, ru.detail
- ru.izm, ru.contractByNum
Тендеры мира
Поиск и детали по id с фильтрами по странам cr{IsoNum}=1.
- world.search, world.detail
Документации закупок
Ищите и анализируйте комплект документации по ключевым словам.
- docs.search
Контракты (победители)
Реестр заключённых контрактов + детали.
- contracts.search, contracts.detail
Контрагенты и контакты
Информация по ИНН и контактные данные организаций.
- contragent.byInn, contragent.contacts
Торги (банкротство/имущество)
Быстрый поиск и детали по лотам.
- torgi.search, torgi.detail
Примеры запросов
Готовые сниппеты для всех инструментов: используйте JSON RPC (POST /mcp) или отладочные HTTP ручки.
{
"jsonrpc":"2.0",
"id": 11,
"method": "tools/call",
"params": {
"name": "ru.search",
"arguments": { "query": "генератор&дизель !услуги", "regions": [77,50], "page": 0 }
}
}{
"jsonrpc":"2.0",
"id": 12,
"method": "tools/call",
"params": {
"name": "ru.detail",
"arguments": { "id": "73321617" }
}
}{
"jsonrpc":"2.0",
"id": 13,
"method": "tools/call",
"params": {
"name": "ru.izm",
"arguments": { "tend_num": "0376300000114000301" }
}
}{
"jsonrpc":"2.0",
"id": 14,
"method": "tools/call",
"params": {
"name": "ru.contractByNum",
"arguments": { "tend_num": "0376300000114000301" }
}
}{
"jsonrpc":"2.0",
"id": 21,
"method": "tools/call",
"params": {
"name": "docs.search",
"arguments": { "query": "кирпич&шамотный", "regions": [50], "page": 0 }
}
}{
"jsonrpc":"2.0",
"id": 31,
"method": "tools/call",
"params": {
"name": "contracts.search",
"arguments": { "query": "ремонт дорог", "regions": [77], "page": 0 }
}
}{
"jsonrpc":"2.0",
"id": 32,
"method": "tools/call",
"params": {
"name": "contracts.detail",
"arguments": { "id": "73321617" }
}
}{
"jsonrpc":"2.0",
"id": 41,
"method": "tools/call",
"params": {
"name": "world.search",
"arguments": { "query": "solar inverter", "countries": [840], "page": 0 }
}
}{
"jsonrpc":"2.0",
"id": 42,
"method": "tools/call",
"params": {
"name": "world.detail",
"arguments": { "id": "2234342" }
}
}{
"jsonrpc":"2.0",
"id": 51,
"method": "tools/call",
"params": {
"name": "contragent.byInn",
"arguments": { "inn": "7734369027" }
}
}{
"jsonrpc":"2.0",
"id": 52,
"method": "tools/call",
"params": {
"name": "contragent.contacts",
"arguments": { "inn": "8620001915" }
}
}{
"jsonrpc":"2.0",
"id": 61,
"method": "tools/call",
"params": {
"name": "torgi.search",
"arguments": { "query": "оборудование", "page": 0 }
}
}{
"jsonrpc":"2.0",
"id": 62,
"method": "tools/call",
"params": {
"name": "torgi.detail",
"arguments": { "id": "176521" }
}
}curl -sS https://tenderguru.ru/mcp/ru/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"генератор&дизель !услуги","regions":[77,50],"page":0}'curl -sS https://tenderguru.ru/mcp/ru/detail \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"73321617"}'curl -sS https://tenderguru.ru/mcp/ru/izm \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tend_num":"0376300000114000301"}'curl -sS https://tenderguru.ru/mcp/ru/contractByNum \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tend_num":"0376300000114000301"}'curl -sS https://tenderguru.ru/mcp/docs/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"кирпич&шамотный","regions":[50],"page":0}'curl -sS https://tenderguru.ru/mcp/contracts/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"ремонт дорог","regions":[77],"page":0}'curl -sS https://tenderguru.ru/mcp/contracts/detail \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"73321617"}'curl -sS https://tenderguru.ru/mcp/world/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"solar inverter","countries":[840],"page":0}'curl -sS https://tenderguru.ru/mcp/world/detail \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"id":"2234342"}'curl -sS https://tenderguru.ru/mcp/contragent/byInn \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inn":"7734369027"}'curl -sS https://tenderguru.ru/mcp/contragent/contacts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inn":"8620001915"}'curl -sS https://tenderguru.ru/mcp/torgi/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"оборудование","page":0}'curl -sS https://tenderguru.ru/mcp/torgi/detail \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id":"176521"}'Быстрый старт и песочница
Отправьте JSON RPC запрос на POST /mcp с ключом доступа в заголовке Authorization: Bearer <API_KEY>.
curl -sS https://tenderguru.ru/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc":"2.0",
"id":1,
"method":"initialize",
"params":{"protocolVersion":"2025-06-18"}
}'
curl -sS https://tenderguru.ru/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc":"2.0",
"id":2,
"method":"tools/call",
"params":{
"name":"ru.search",
"arguments":{ "query":"щебень|песок !услуги", "regions":[77,50], "page":0 }
}
}'
Для быстрых интеграций есть отладочные HTTP ручки, например POST /mcp/ru/search с телом {"query":"ремонт","regions":[50],"page":0}.
Мини песочница
Язык поисковых запросов
Морфология и регистр
Поиск морфологический: запрос «генераторы» находит также «генератор», «генераторов», «генератора» и т.д.
Регистр не имеет значения: «Кирпич» = «кирпич».
Операторы
- & — И (по умолчанию). Пример: Кирпич&шамотный
- | — ИЛИ. Пример: щебень|песок
- ! — ИСКЛЮЧЕНИЕ. Пример: смартфон !услуги !связь
- "…" — фраза. Пример: "источник бесперебойного питания"
- = — точная форма. Пример: =аудит
Фильтры и пагинация
Передавайте regions: [50,77] — сервер превратит в r50=1&r77=1. Можно и напрямую: {"filters":{"r50":1}}.
Для world.search используйте countries: [840] — станет cr840=1.
Параметр page — 0,1,2…
API и инструменты
MCP: POST /mcp (JSON RPC 2.0). Отладка: HTTP ручки.
JSON RPC методы
| Метод | Описание |
|---|---|
initialize | Рукопожатие протокола, возвращает версии и возможности. |
tools/list | Список инструментов и их схемы ввода. |
tools/call | Вызов инструмента с name и arguments. |
Инструменты
| name | Назначение |
|---|---|
ru.search | Поиск тендеров РФ |
ru.detail | Детали тендера РФ по id |
ru.izm | Изменения по номеру тендера |
ru.contractByNum | Кто выиграл тендер (по номеру) |
docs.search | Документации закупок |
contracts.search | Контракты (победители) |
contracts.detail | Детали контракта по id |
world.search | Поиск тендеров мира |
world.detail | Детали тендера мира по id |
contragent.byInn | Информация по ИНН |
contragent.contacts | Контакты по ИНН |
torgi.search | Поиск по торгам |
torgi.detail | Детали торгов по id |
HTTP ручки для отладки
POST /mcp/ru/search,/mcp/ru/detail,/mcp/ru/izm,/mcp/ru/contractByNumPOST /mcp/docs/searchPOST /mcp/contracts/search,/mcp/contracts/detailPOST /mcp/world/search,/mcp/world/detailPOST /mcp/contragent/byInn,/mcp/contragent/contactsPOST /mcp/torgi/search,/mcp/torgi/detailGET /search/syntax— кратко о языке запроса
curl -sS https://tenderguru.ru/mcp/ru/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"ремонт","regions":[50],"page":0}'
FAQ
Где работает?
Десктопные Claude и LM Studio
Пример запроса в OpenAI API
from openai import OpenAI
import os
os.environ["OPENAI_API_KEY"] = "ключ API chatGpt"
client = OpenAI(timeout=50, max_retries=0)
print("MCP")
resp = client.responses.create(
model="gpt-4o-mini",
tools=[
{
"type": "mcp",
"server_label": "tenderguru",
"server_url": "https://www.tenderguru.ru/mcp",
"headers": {
"authorization": "Bearer <ключ API tenderguru.ru>"
},
"require_approval": "never"
}
],
input="запрос"
)
print(resp.output_text) 