MCP

Partners tools

MCP tools for partners: what each does, the key level it needs, the operation it runs and its input schema. Part of the MISSIN public API: call it with an API…

An operation tool runs one API operation and takes its variables, so the operation's page says what each accepts. Two differences: the server fills in workspaceId and updatedBy, and campaignId, partnerId, formId, discountCodeId, socialNetworkId, waitlistId, incentiveId, channelId also take the record's name. A task tool chains several operations and is described here in full. Every tool's input schema, keyed by tool name: partners.schema.json.

Task tools

`save_partner`

Access: Write · Kind: task · Toolset: core · Hints: idempotent

Find or create a partner by their social handles. Returns the existing partner if any handle is already known (attaching any new handles), otherwise creates the partner with every handle watched for capture. Several writes, not atomic: the partner is created first, then each handle; if a handle fails the partner and earlier handles stay, the error says so, and running it again finishes the rest. Returns { partner, created, handles }.

Try: “Make a partner for @test11 on Instagram and TikTok.”

Input schema

json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "description": "Display name. Defaults to the first handle.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "handles": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string",
            "minLength": 1,
            "description": "instagram, tiktok, youtube, twitter (or x), facebook — any network list_social_networks returns."
          },
          "handle": {
            "type": "string",
            "minLength": 1,
            "description": "The @handle or a profile URL."
          }
        },
        "required": [
          "platform",
          "handle"
        ]
      }
    }
  },
  "required": [
    "handles"
  ]
}

Operation tools

Tool	Operation	Access	Toolset	Hints	What it does
`add_partner_to_campaign`	AddPartnerToCampaign	Write	`partners`		Add a partner to a campaign. The workspace's default campaign is refused.
`approve_partner`	ApprovePartner	Write	`partners`		Approve a pending partner, or fold it into an existing partner.
`approve_partner_suggestion`	ApprovePartnerSuggestion	Write	`partners`		Turn a suggested handle into a partner and rescore attribution.
`create_partner`	CreatePartner	Write	`partners`		Create a partner; body needs name and @username. Add handles with CreatePartnerSocialNetwork.
`create_partner_social_network`	CreatePartnerSocialNetwork	Write	`partners`		Add a social handle to a partner on one network; socialNetworkId comes from SocialNetworksLookup.
`delete_partner`	DeletePartner	Write	`partners`	destructive	Delete a partner with no history; a partner with posts or orders is refused. Irreversible.
`dismiss_duplicate_pair`	DismissDuplicatePair	Write	`partners`		Mark two partners as not duplicates.
`dismiss_partner_suggestion`	DismissPartnerSuggestion	Write	`partners`		Dismiss a suggested partner handle.
`get_likely_duplicate_partners`	LikelyDuplicatePartners	Read	`partners`	read-only, idempotent	List partner pairs that look like the same person, with what matched.
`merge_partners`	MergePartners	Write	`partners`	destructive	Merge two partners with per-field resolutions; the losing partner is deleted. Irreversible.
`get_partner_evidence`	PartnerEvidence	Read	`partners`	read-only, idempotent	Evidence for one partner since a date: posts, form mentions and attributed orders.
`list_partners`	PartnersList	Read	`core`	read-only, idempotent	List partners with filter and cursor paging: name, @username, status, handles per network and campaigns. Totals and detail are off unless requested: set withDetail to true to include them.
`get_partner_suggestions`	PartnerSuggestions	Read	`partners`	read-only, idempotent	Handles customers named in forms that are not partners yet.
`get_partner_value`	PartnerValue	Read	`partners`	read-only, idempotent	One partner's attributed revenue, orders and return in a window.
`get_pending_partners`	PendingPartners	Read	`partners`	read-only, idempotent	Partners awaiting approval, with the existing partner each one may match.
`preview_partner_merge`	PreviewPartnerMerge	Read	`partners`	read-only, idempotent	Preview merging two partners: what would move and what conflicts.
`remove_partner_from_campaign`	RemovePartnerFromCampaign	Write	`partners`	destructive	Remove a partner from a campaign.
`resync_partner_profile`	ResyncPartnerProfile	Write	`partners`	destructive	Refresh a partner's profile and avatar from the platform; spends capture credits. Spends capture credits and cannot be priced ahead: tell the merchant it spends credits and get a yes before calling.
`set_handle_watched`	SetHandleWatched	Write	`partners`	destructive, idempotent	Turn capture on or off for one partner handle; body is { watched }. Commits recurring spend: scheduled captures that follow from this spend credits on every run, so confirm with the merchant first.
`list_social_networks`	SocialNetworksLookup	Read	`core`	read-only, idempotent	List the workspace's social networks (instagram, tiktok and so on) with ids and slugs.
`update_partner_details`	UpdatePartnerDetails	Write	`partners`		Update a partner's name, @username, email, budget, dates, status or UTM values.
`update_partner_trust`	UpdatePartnerTrust	Write	`partners`		Mark a partner trusted or untrusted.