Skip to main content
Glama
partna-mcp

partna-mcp

Official
by partna-dev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PARTNA_API_KEYNoTenant API key used for reading.
PARTNA_BACKENDNoBackend mode; setting it to `http` makes the server talk to the bridge or core over HTTP.
PARTNA_BRIDGE_URLNoURL of the PARTNA bridge.
PARTNA_ENGINE_URLNoURL of the PARTNA engine/core.
PARTNA_BRIDGE_TOKENNoBridge 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: привязка клиентов к коду партнёра, участники, заказы, возвраты, ссылки и чтение сводки.

Порядок работы:

  1. status — проверить, что сервис доступен и ключ задан.

  2. partner_link — получить ссылку партнёра.

  3. claim — привязать клиента, когда он зарегистрировался.

  4. order и refund — сообщать об оплатах и возвратах.

eventId у каждой записи уникален навсегда: повтор с тем же eventId не должен приводить к повторному начислению. У пишущих инструментов есть dry_run: он показывает тело запроса и ничего не отправляет.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Контракт фактов 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

C2.6/5.0

Scored across 9 tools

Disambiguation3/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues