База даних для ШІ-клієнтів

Додай один сервер — і Claude, Cursor, Claude Desktop чи інший клієнт MCP зможе напряму звертатися до FDB4. Без власного клієнтського коду й ручного розбору JSON. Адреса https://fdb4.io/mcp та сама, що й у цієї сторінки: браузер отримує документацію, клієнт — протокол.

6 із 11 інструментів узагалі не потребують ключа. Додай сервер без облікових даних: відповіді повні, ліміт — 60 викликів на годину з адреси. Решта 5 коштують по балу й повертають анонімному клієнту запрошення замість даних — словами, які помічник може переказати користувачу. REST API не має безкоштовного рівня: /v1 — платний продукт.

Адреса fdb4.io/mcp POST, потоковий HTTP

Безкоштовні інструменти 6 із 11 без ключа й реєстрації

Без ключа 60/год на IP-адресу

Із ключем 120/хв спільно з /v1

Підключення для початку ключ не потрібен

Claude Code — без ключа, лише безкоштовні інструменти

claude mcp add --transport http fdb4 https://fdb4.io/mcp

Claude Code — із ключем, усе

claude mcp add --transport http fdb4 https://fdb4.io/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Claude Desktop / Cursor / будь-який клієнт із блоком mcpServers

{
  "mcpServers": {
    "fdb4": {
      "type": "http",
      "url": "https://fdb4.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Для безкоштовних інструментів видали весь блок headers.

curl — перелік інструментів (безкоштовно, без списання балів, ключ необов'язковий)

curl -X POST https://fdb4.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Підключення (initialize), перелік інструментів (tools/list) і ping безкоштовні з ключем чи без: агент, який не може прочитати меню, не стане клієнтом. GET із браузера за цією адресою показує цю сторінку; GET із запитом потоку подій повертає 405, бо сервер нічого не надсилає самостійно.

Де межа безкоштовного й чому 6 безкоштовних · 5 платних

Інструмент безкоштовний, якщо читає таблицю, вже заповнену індексатором, і запит обмежений. Платний — якщо повертає результат моделі, рейтинг усіх команд або необмежену частину історії.

За замовчуванням інструменти платні, а безкоштовність — виняток: новий інструмент коштує бал, доки не вирішено інакше. Кожен інструмент повідомляє власну ціну, а сторінка читає її з робочого сервера. Зміна ціни одразу змінює таблиці нижче. Безкоштовний інструмент безкоштовний для всіх: наявність ключа нічого не змінює, бали за нього не списуються.

Безкоштовні інструменти — без ключа, акаунта й оплати 6 інструментів

Усі довідкові запити й головний показник: скільки матчів команда не грає внічию. Разом вони перетворюють назву на ідентифікатор, показують турніри й відповідають, що сталося минулими вихідними. Цього зазвичай вистачає помічнику до запиту ключа.

Інструмент	На що відповідає	Аргументи	Ціна
`get_team_streaks`	Усі серії команди без нічиїх за всю історію та її поточна серія.	team*	Безкоштовно — ключ не потрібен
`list_teams`	Знайти команду та її ID — основа інших інструментів для команд.	q, type, letter, limit	Безкоштовно — ключ не потрібен
`get_team`	Профіль команди та статистика нічиїх за всю історію.	team*	Безкоштовно — ключ не потрібен
`list_tournaments`	Усі наявні турніри — ліги, національні й континентальні кубки, чемпіонати світу — з кількістю матчів і нічиїх.	tournament, limit	Безкоштовно — ключ не потрібен
`list_countries`	Усі країни бази з кодом FIFA та ID.	q, limit	Безкоштовно — ключ не потрібен
`search_results`	Пошук архіву: завершені матчі з рахунками, від найновіших.	team_id, competition_id, competition_item_id, outcome, type, from, to, limit, page	Останні 7 днів безкоштовно (перша сторінка з 50); давніший архів коштує 1 бал

* обов'язкові. Інструменти списків за замовчуванням повертають 25 рядків зі справжньою загальною кількістю. Якщо total більше за returned, звузь фільтри замість сліпого гортання. search_results має ціну залежно від виклику: перша сторінка з 50 рядків за останні 7 днів безкоштовна; давніші дані, більша сторінка чи будь-яка наступна сторінка платні.

Платні інструменти — по 1 балу 5 інструментів · 1 бал = 1 цент

Моделі й рейтинги. Кожен інструмент запускає навчену модель, сортує всі команди або читає необмежений архів — роботу, яку сайт виконує щоночі й продає за виклик. Без ключа вони нічого не коштують і не повертають даних: відповідь містить помилку key_required, ціну, безкоштовні альтернативи та спосіб отримати ключ.

Інструмент	На що відповідає	Аргументи	Ціна
`predict_draws`	Рейтинг команд за очікуванням нічиєї — головне запитання цієї бази.	type, recent, wc2026, limit	1 бал
`get_team_prediction`	Очікування нічиєї для обраної команди та результати, що до нього привели.	team*, recent, wc2026	1 бал
`get_draw_model`	Усі оцінки нічиєї FDB4 для ОДНОГО матчу: коли потрібна ймовірність нічиєї в конкретному матчі, а не перелік команд, які її очікують (для цього є `predict_draws`).	match_id, team, date	1 бал
`top_streaks`	Історичний рейтинг серій без нічиїх — найдовші серії будь-якої команди.	min, team_id, type, limit, page	1 бал
`head_to_head`	Повна статистика особистих зустрічей двох команд і всі їхні матчі.	a, b, type, item	1 бал

* обов'язкові. Виклик із пагінацією коштує бал за сторінку, тож запитуй потрібне за один виклик. Навіть порожній результат коштує бал — як і на /v1, де списання відбувається до контролера.

Як отримати ключ створення безкоштовне

Увійти через Google — без пароля, форми й очікування.
Створи ключ у своєму акаунті. Він показується лише раз, тож збережи його надійно.
Надсилай його як Authorization: Bearer <key> — до https://fdb4.io/mcp або https://fdb4.io/v1. Один ключ і баланс для обох інтерфейсів.

За реєстрацію 10 бал. безкоштовно, без картки

Щомісяця +2 бал. якщо входиш

За платний виклик 1 бал. = 1 цент

За безкоштовний виклик 0 із ключем чи без

1 виклик = 1 бал = 1 цент у платній частині та нічого в безкоштовній. Бали закінчилися? Поповнити — суму обираєш ти, без пакетів і підписки. Запроси когось і отримуй 10% від усіх його нарахувань. Повернень немає: продукт — дані, а дані неможливо повернути.

Ліміти й відмови що й коли отримує клієнт

анонімно 60 викликів на годину з IP-адреси

Клієнт без ключа має окремий погодинний ліміт, незалежний від захисту REST API від сплесків. Погодинний, а не похвилинний, бо тут без ключа повертаються дані, а не 401. Перевищення дає 429 без списання балів із заголовком Retry-After.

із ключем 120 викликів на хвилину спільно з /v1

Похвилинний ліміт ключа спільний для обох інтерфейсів: разом 120, а не по 120 кожному. Одне повідомлення JSON-RPC — один HTTP-запит, тому виклик інструмента й tools/list однаково враховуються в ліміті.

key_required платний інструмент без ключа

Це не HTTP 401 і не помилка з'єднання, а результат інструмента з помилкою, яку помічник може переказати людині. Він містить ціну, безкоштовні альтернативи й дві адреси для вирішення. Нічого не списано.

401 надісланий ключ непридатний

Хибний ключ — помилка, відсутність ключа — вибір. Невідомий, відкликаний чи прострочений ключ відхиляється так само, як на /v1. Брак балів повертає помилку insufficient_balance з адресою поповнення, теж без списання.

Одне відхилення від специфікації MCP повідомляємо відразу

Розділ авторизації специфікації передбачає OAuth 2.1 із динамічною реєстрацією клієнтів. FDB4 натомість використовує ті самі статичні bearer-ключі, що й REST API: це простіше й відповідає наявному продажу API. Працює кожен клієнт із власним заголовком; клієнт лише з OAuth не підключиться. Напиши нам, якщо це потрібно.

Шукаєш REST API? /v1 · платно, без безкоштовного рівня

Ті самі дані як звичайний JSON через GET для власного коду: усі адреси, параметри, приклад відповіді й запити шістьма мовами. Безкоштовного рівня немає: кожен /v1 потребує ключа й коштує бал. Ключ і баланс спільні з платними інструментами тут.

Довідник REST API ›