Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SYNDICATE_API_URL | Yes | API base URL (`https://api.syndicatelinks.co`) | |
| AGENT_TOKEN_SECRET | No | Secret for verifying attribution tokens | |
| SYNDICATE_AGENT_KEY | No | Agent-scoped key (`aff_agent_` prefix) for tracking conversions and checking commissions | |
| SYNDICATE_ADMIN_SECRET | No | Admin secret for running payout cycles | |
| SYNDICATE_MERCHANT_KEY | No | Merchant key (`mk_live_` prefix) for listing your own programs |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| track_agent_conversionA | Record a conversion event driven by an AI agent. Requires a valid attribution token (slat_v1_ prefix) previously issued for this affiliate. The commission is auto-approved. Returns eventId, commissionAmount, and commissionStatus. |
| verify_attribution_tokenA | Decode and validate a Syndicate Links attribution token (slat_v1_ prefix). Returns the token payload (affiliateId, programId, trackingCode, issuedAt, expiry) if valid, or an error description if the token is invalid or expired. Does not record a conversion — use track_agent_conversion for that. |
| get_commission_statusA | Return the commission balance for the authenticated affiliate (identified by SYNDICATE_AGENT_KEY). Returns available (approved and ready to pay out), pending (not yet approved), and lifetime totals in USD. |
| run_payout_cycleA | Trigger the GLOBAL payout cycle. Processes all approved commissions for ALL affiliates in a single batch run — this is not scoped to a single affiliate or commission. Requires SYNDICATE_ADMIN_SECRET. Returns counts of payouts processed, created, succeeded, and failed. Note: v1 does not support targeting a single affiliate; a per-affiliate settle endpoint is a known future addition. |
| list_merchant_programsA | List affiliate programs belonging to the authenticated merchant (identified by SYNDICATE_MERCHANT_KEY). Returns the API response shape |
| search_programsA | Full-text search across affiliate program names and descriptions. Returns matching programs with commission rates, category, and status. Use this to find programs by keyword (e.g., "electronics", "SaaS", "fitness"). Results are paginated — pass the returned cursor to fetch subsequent pages. Response shape: { data: Program[], cursor: string | null, hasMore: boolean }. |
| get_program_detailsA | Get comprehensive details for a specific affiliate program. Returns commission rates (percentage or flat), attribution window, auto-approval status, merchant info, conversion stats (total conversions, average order value, total revenue), product catalog with per-product commission rates, and anonymized top performer data. Use this after search_programs to evaluate whether a program is worth promoting. The program ID comes from search_programs or list_merchant_programs results. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |