partna-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@partna-mcp register a new member for partner code SUMMER20"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
partna-mcp
MCP-сервер партнёрской программы Partna: агент заводит участников, сообщает об оплатах и возвратах, выдаёт ссылки партнёрам и читает сводку. Деньги через сервер не проходят: он только передаёт факты и читает цифры.
Обзор, установка и глоссарий — в документации: https://partna.dev/docs/
Что внутри
Пакет с портом и адаптерами:
MCP-инструменты
│
▼
порт PartnerApi — операции повторяют сервисные функции ядра
├── HttpBackend — по публичному контракту фактов (этот пакет)
└── LocalBackend — в закрытом репозитории ядра, вызывает use casesИнструменты не знают, куда именно они ходят: PARTNA_BACKEND=http говорит с
мостом или ядром по HTTP. Локальный адаптер ставится отдельно и доступен только
там, где есть доступ к базе.
Related MCP server: Fuul MCP Server
Инструменты
Инструмент | Что делает |
| доступность сервиса, режим, задан ли ключ |
| ссылка партнёра для его клиентов |
| привязать клиента к коду партнёра |
| участник программы и от кого пришёл |
| клиент оплатил |
| клиенту вернули деньги |
| привязан ли клиент и к какому коду |
| сводка партнёра |
| история выплат |
Пишущие инструменты принимают dry_run: он показывает тело запроса и ничего не
отправляет.
Запуск
export PARTNA_BRIDGE_URL=https://partna.client.com
export PARTNA_BRIDGE_TOKEN=... # токен моста, если он задан
export PARTNA_ENGINE_URL=https://networks.partna.dev
export PARTNA_API_KEY=... # ключ тенанта для чтения
uvx partna-mcpТранспорт — stdio. Подключение в клиенте:
{
"mcpServers": {
"partna": {
"command": "uvx",
"args": ["partna-mcp"],
"env": {
"PARTNA_BRIDGE_URL": "https://partna.client.com",
"PARTNA_ENGINE_URL": "https://networks.partna.dev",
"PARTNA_API_KEY": "..."
}
}
}
}Если моста нет, задайте только PARTNA_ENGINE_URL и PARTNA_API_KEY: факты
пойдут прямо в ядро его путями.
Правила
eventIdуникален навсегда: один факт — один идентификатор, повтор не должен давать второе начисление.Ключи берутся только из окружения; инструменты не принимают их аргументами и не печатают в ответах.
Ошибки возвращаются текстом сервиса без стеков и без секретов.
Контракт
Пять операций описаны в
partna-bridge/spec.
Golden-кейсы лежат в пакете (src/partna_mcp/golden/) и доступны через
partna_mcp.golden.load_cases() — общий эталон для HTTP- и локального адаптера:
одинаковый вход должен давать одинаковый ответ.
Лицензия
MIT — см. LICENSE.
Available Tools
9 toolsclaimC
Привязать клиента к коду партнёра. Клиент уже зарегистрирован у владельца; external_account_id — его идентификатор там
Inputs: code (required), external_account_id (required), dry_run. Returns: object
dashboardC
Сводка партнёра: начислено, выплачено, доступно, приглашённые
Inputs: member_id (required). Returns: object
memberC
Участник программы и от кого он пришёл. eventId уникален навсегда
Inputs: event_id (required), member_id (required), occurred_at (required), leg, +4 more. Returns: object
orderC
Клиент оплатил. amount — в минорных единицах (500000 = 5000.00), personalVolume — объём для расчёта плана
Inputs: amount (required), currency (required), event_id (required), order_id (required), +7 more. Returns: object
partner_linkD
Ссылка партнёра: по ней приходят его клиенты
Inputs: external_account_id (required), dry_run, destination_url. Returns: object
payoutsC
История выплат партнёра
Inputs: member_id (required). Returns: object
referral_statusC
Привязан ли клиент и к какому коду
Inputs: external_account_id (required). Returns: object
refundC
Клиенту вернули деньги: ядро откатит начисление
Inputs: amount (required), currency (required), event_id (required), order_id (required), +4 more. Returns: object
statusC
Доступность сервиса, режим и наличие ключа
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Run your affiliate program from any agent: partners, commissions, payouts, bounties, recruitment.
Search and discover affiliate programs with agent-ready data and commission details.
Manage affiliate programs, partners, referrals, commissions, and payouts through Affonso.
Browse affiliates, referrals, commissions and payouts, and set up campaigns and affiliates.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to access affiliate marketing capabilities through AgentFuse's API, allowing them to browse affiliate programs, generate tracked links, and record conversions without writing HTTP code.7MIT
- AlicenseAqualityCmaintenanceManages affiliate programs, analytics, incentives, and payouts through MCP-compatible clients.3935 npmMIT
- AlicenseNot gradedqualityFmaintenanceEnables agents to accept and spend payments via Rill's network, including pay links, wallets, and Connect onboarding.MIT
- AlicenseCqualityBmaintenanceIt enables AI agents and command-line users to manage short links, analytics, conversions, partner workflows, commissions, payouts, and private workspace profiles with explicit write controls and exact reviewed batch submissions.619 npmAGPL 3.0