# Incentives tools

> MCP tools for incentives: 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…

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: [incentives.schema.json](https://developer.missin.co.uk/mcp/tools/incentives.schema.json).

> **Warning:**
> Destructive: `decline_incentive_grant`, `delete_incentive`, `replace_incentive_rules`. An agent must say what it will change and wait for the merchant's yes before calling one.

## Operation tools

| Tool | Operation | Access | Toolset | Hints | What it does |
|---|---|---|---|---|---|
| `create_incentive` | [CreateIncentive](https://developer.missin.co.uk/reference/incentives/create-incentive.md) | Write | `incentives` |  | Create an incentive with its rules: what a customer earns and when. |
| `decline_incentive_grant` | [DeclineIncentiveGrant](https://developer.missin.co.uk/reference/incentives/decline-incentive-grant.md) | Write | `incentives` | destructive | Decline a held incentive grant. Irreversible. |
| `delete_incentive` | [DeleteIncentive](https://developer.missin.co.uk/reference/incentives/delete-incentive.md) | Write | `incentives` | destructive | Delete an incentive. Irreversible. |
| `get_incentive` | [IncentiveDetail](https://developer.missin.co.uk/reference/incentives/incentive-detail.md) | Read | `incentives` | read-only, idempotent | Get one incentive by id with its rules, grants and limits. |
| `get_incentive_kinds` | [IncentiveKinds](https://developer.missin.co.uk/reference/incentives/incentive-kinds.md) | Read | `incentives` | read-only, idempotent | List incentive kinds (discount code, gift card, free product and so on) and the fields each needs. |
| `get_incentive_rule_unresolved_recipient_count` | [IncentiveRuleUnresolvedRecipientCount](https://developer.missin.co.uk/reference/incentives/incentive-rule-unresolved-recipient-count.md) | Read | `incentives` | read-only, idempotent | How many recipients of one incentive rule could not be resolved to a customer. |
| `list_incentives` | [IncentivesList](https://developer.missin.co.uk/reference/incentives/incentives-list.md) | Read | `incentives` | read-only, idempotent | List incentives with their rules, grant counts, redemptions and estimated value. |
| `get_incentive_trust` | [IncentiveTrust](https://developer.missin.co.uk/reference/incentives/incentive-trust.md) | Read | `incentives` | read-only, idempotent | One incentive's minimum trust score and the grants it held back. |
| `release_incentive_grant` | [ReleaseIncentiveGrant](https://developer.missin.co.uk/reference/incentives/release-incentive-grant.md) | Write | `incentives` |  | Release a held grant so it is issued to the customer. |
| `replace_incentive_rules` | [ReplaceIncentiveRules](https://developer.missin.co.uk/reference/incentives/replace-incentive-rules.md) | Write | `incentives` | destructive | Replace an incentive's rules; the old ones are not kept. Irreversible. |
| `get_response_trust_floor` | [ResponseTrustFloor](https://developer.missin.co.uk/reference/incentives/response-trust-floor.md) | Read | `incentives` | read-only, idempotent | The minimum trust score of the incentives attached to one form. |
| `update_incentive` | [UpdateIncentive](https://developer.missin.co.uk/reference/incentives/update-incentive.md) | Write | `incentives` |  | Update an incentive's name, audience, limits, status or trust floor. |

Source: https://developer.missin.co.uk/mcp/tools/incentives