partna-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PARTNA_API_KEY | No | Tenant API key used for reading. | |
| PARTNA_BACKEND | No | Backend mode; setting it to `http` makes the server talk to the bridge or core over HTTP. | |
| PARTNA_BRIDGE_URL | No | URL of the PARTNA bridge. | |
| PARTNA_ENGINE_URL | No | URL of the PARTNA engine/core. | |
| PARTNA_BRIDGE_TOKEN | No | Bridge token, if the bridge requires one. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Партнёрская программа Partna: привязка клиентов к коду партнёра, участники, заказы, возвраты, ссылки и чтение сводки.
Порядок работы:
status — проверить, что сервис доступен и ключ задан.
partner_link — получить ссылку партнёра.
claim — привязать клиента, когда он зарегистрировался.
order и refund — сообщать об оплатах и возвратах.
eventId у каждой записи уникален навсегда: повтор с тем же eventId не должен приводить к повторному начислению. У пишущих инструментов есть dry_run: он показывает тело запроса и ничего не отправляет.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| statusC | Доступность сервиса, режим и наличие ключа |
| claimC | Привязать клиента к коду партнёра. Клиент уже зарегистрирован у владельца; external_account_id — его идентификатор там |
| memberC | Участник программы и от кого он пришёл. eventId уникален навсегда |
| orderC | Клиент оплатил. amount — в минорных единицах (500000 = 5000.00), personalVolume — объём для расчёта плана |
| refundC | Клиенту вернули деньги: ядро откатит начисление |
| partner_linkD | Ссылка партнёра: по ней приходят его клиенты |
| referral_statusC | Привязан ли клиент и к какому коду |
| dashboardC | Сводка партнёра: начислено, выплачено, доступно, приглашённые |
| payoutsC | История выплат партнёра |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Контракт фактов v1 | Пять операций записи: claim, member, order, refund, partner-link. Схема: https://github.com/partna-dev/partna-bridge/blob/main/spec/README.md |
| Уровни интеграции | Четыре уровня: готовая ссылка, своя регистрация, свой граф, свои экраны. Описание: https://github.com/partna-dev/partna-bridge/blob/main/docs/integrations/README.md |
TDQS
Scored across 9 tools
Most tools target distinct actions or resources, but claim, member, and referral_status all touch client-to-partner attribution and could be confused without reading descriptions closely. partner_link, order, refund, dashboard, and payouts are clearer.
All names are lowercase snake_case or single words, which is readable, but the set mixes nouns (member, dashboard), actions (claim, refund), and event-like names (order), without a predictable verb_noun convention.
Nine tools is well-scoped for a partner/referral program integration. Each tool appears to cover a meaningful operation or query without excessive surface area.
The surface covers service status, partner links, attribution, orders, refunds, referral status, dashboard summaries, and payout history. Minor gaps may exist around listing/managing members or payouts, but core lifecycle operations are represented.