post
https://bonus.ly/mcp##claimIncentive
Claim a claimable award ("incentive") for yourself in the caller's
company.
Inputs:
award_id(string) — the BSON id of the incentive to claim. Use the
listAwardstool withtype: "claimable"to discover incentives.award_name(string) — alternative toaward_id: the incentive's
exact name (case-insensitive). Ifaward_idis given it wins.claim_reason(string, optional) — a note explaining the claim
(shown to approvers).privacy(string, optional) — one of publicly_visible, privately_visible, immediate_team.
Only honored when the incentive allows changing privacy.
Claiming creates an approval request. Auto-approved incentives return
the created bonus immediately; incentives with an approval process
return a pending approval_request and bonus: null.
Proof attachments are not supported over MCP. If an incentive requires
proof, claim it through the web app so you can attach the artifact.
Required OAuth scope: recognition:write
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Unauthorized
403Forbidden