API для розробників: як інтегрувати 56+ юридичних MCP інструментів у свій продукт
6 вкладок документації: Overview, каталог 56 інструментів, автентифікація, приклади коду (curl/TS/Python/SSE), конфіги MCP-клієнтів (Claude Desktop/Cursor/VS Code), прайсинг. Від реєстрації до першого запиту — 5 хвилин.
API для розробників: як інтегрувати 56+ юридичних MCP інструментів у свій продукт
Повний гід по документації, транспортах та інтеграції — від curl до Claude Desktop.
Навіщо ми зробили /developer/docs
Ми відкрили API ще у лютому. Але документація була в README на GitHub, приклади — у Telegram-чаті підтримки, а конфіги MCP-клієнтів — у різних docs-файлах по репозиторію. Розробники витрачали більше часу на пошук інформації, ніж на саму інтеграцію.
Тепер все в одному місці: legal.org.ua/developer/docs — 6 вкладок, від огляду до прайсингу.
Вкладка 1: Overview — що таке LEX API
LEX API — це юридичний AI-бекенд, доступний через три транспорти:
| Транспорт | Протокол | Для кого |
|---|---|---|
| MCP SSE | Server-Sent Events | Claude Desktop, Cursor, VS Code, Continue.dev |
| REST | HTTP POST | Будь-яка мова програмування |
| Batch | HTTP POST | Масові запити (до 10 інструментів за раз) |
Один API-ключ працює для всіх трьох транспортів. Формат: sl_<32 символи>_<8 контрольна сума>.
Base URL:
REST: https://mcp.legal.org.ua/api/tools/{toolName}
MCP SSE: https://mcp.legal.org.ua/v1/sse
Batch: https://mcp.legal.org.ua/api/tools/batch
Вкладка 2: Каталог інструментів — 56 tools у 12 категоріях
Повний інтерактивний каталог з пошуком та фільтрацією. Кожен інструмент має:
- Назву та опис
- Категорію (Court, Analysis, Legislation, Registry, etc.)
- Діапазон вартості (від $0.001 до $0.05 за виклик)
- Input schema — JSON-схема параметрів
Топ-10 найпопулярніших інструментів
| # | Інструмент | Категорія | Вартість |
|---|---|---|---|
| 1 | search_court_decisions |
Court | $0.005–0.02 |
| 2 | get_legislation_section |
Legislation | $0.002–0.01 |
| 3 | search_entities |
Registry | $0.003–0.01 |
| 4 | fulltext_search |
Court | $0.01–0.03 |
| 5 | analyze_query |
Pipeline | $0.02–0.05 |
| 6 | get_by_edrpou |
Registry | $0.002–0.005 |
| 7 | search_debtors |
Registry | $0.003–0.01 |
| 8 | compare_decisions |
Analysis | $0.02–0.05 |
| 9 | get_decision_details |
Court | $0.005–0.02 |
| 10 | search_legal_acts |
Legislation | $0.003–0.01 |
Вкладка 3: Автентифікація
Три способи отримати API-ключ:
1. Через Developer Platform
Зайти на platform.legal.org.ua, залогінитись, створити ключ у розділі API Keys.
2. Через основний додаток
Меню профілю → "API документація" → перенаправлення на портал.
3. Через API
POST /api/keys
Authorization: Bearer <session_token>
Content-Type: application/json
{"name": "My Integration Key"}
Відповідь містить ключ один раз — зберігайте одразу. Потім видно лише останні 8 символів.
Використання ключа
Заголовок Authorization: Bearer sl_your_key у кожному запиті.
Вкладка 4: Приклади коду — 5 мов/інструментів
cURL
curl -X POST https://mcp.legal.org.ua/api/tools/search_court_decisions \
-H "Authorization: Bearer sl_your_key" \
-H "Content-Type: application/json" \
-d '{"query": "визнання правочину недійсним", "limit": 10}'
TypeScript / Node.js
import axios from 'axios';
const client = axios.create({
baseURL: 'https://mcp.legal.org.ua/api/tools',
headers: { Authorization: 'Bearer sl_your_key' }
});
const { data } = await client.post('/search_court_decisions', {
query: 'стягнення боргу за кредитним договором',
limit: 20
});
console.log(data.results);
Python
import requests
API_KEY = "sl_your_key"
BASE = "https://mcp.legal.org.ua/api/tools"
resp = requests.post(
f"{BASE}/search_court_decisions",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"query": "аліменти", "limit": 10}
)
for decision in resp.json()["results"]:
print(f"{decision['case_number']}: {decision['court_name']}")
SSE Streaming (для довгих операцій)
``\