<!-- Generated from Cogny's tool registry. Canonical page: https://cogny.com/integrations/passionfroot/tools -->

# Passionfroot tools in Cogny

Cogny's Passionfroot integration exposes 14 tools (9 read, 3 write, 2 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

- **Read** (9): only reads data.
- **Write** (3): creates or changes something.
- **Destructive** (2): deletes, removes or replaces something.

Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations.

## Notes

Passionfroot connects with a Partner API key from your brand workspace: Settings → AI agents & API. Keys are shown once and carry the expiry date you pick; when one expires, create a new key and update the connection. A key from a creator account is not supported. If Passionfroot answers that your plan doesn't include API access, ask Passionfroot to enable it for your workspace.

The key only sees your own workspace: the creators you have a collaboration with, your collaborations and campaigns, placements, and your conversations with creators.

Results are the views, likes, comments and shares Passionfroot has on each placement. A placement with nothing reported yet shows empty metrics, and `get_sponsorship_summary` leaves it out of CPM and cost per engagement instead of counting it as zero. Spend is each placement's price as Passionfroot reports it, added up in USD, with the original currencies listed next to it. `get_sponsorship_summary` reads up to 5,000 placements per call; a longer window says so and asks for a shorter one.

Passionfroot allows 2 API requests per second per key.

Writes stay ask-first until you allow them in Settings. An inquiry or a message is delivered to the creator as the Passionfroot member who created the key. Accepting a proposal books a paid collaboration at the proposal's price and dates; rejecting one cancels the collaboration.

## Known gaps

- Campaigns can't be created or edited, and creators can't be searched outside the ones you already have a collaboration with (an inquiry needs a creator id you already know).
- No counter-offers or brand-side proposals: a creator's proposal can be accepted or rejected, not changed.
- No conversions, clicks or revenue per placement; tie results to sales with UTMs or discount codes in your own analytics.
- Collaborations, placements and creator notes and labels are read only; messages can't be edited or deleted, and attachments can't be sent.

## All tools

| Tool | Kind | What it does |
|---|---|---|
| `get_sponsorship_summary` | Read | See creator-sponsorship spend and results for a period: placements, spend, views, engagement, CPM and cost per engagement, grouped by creator, platform, campaign or month. |
| `list_placements` | Read | List your sponsored placements on Passionfroot with date, status, platform, link, reported views, likes, comments and shares, and price. |
| `list_collaborations` | Read | List your sponsorship deals with creators on Passionfroot: status, price, campaign and when they changed. |
| `get_collaboration` | Read | Get one sponsorship deal on Passionfroot with its status, price and campaign. |
| `list_creators` | Read | List the creators you've worked with on Passionfroot, with your private notes and labels, and optionally their channels and audience metrics. |
| `get_creator` | Read | Get one creator you've worked with on Passionfroot: country, your notes and labels, and their channels with audience metrics. |
| `list_creator_labels` | Read | List the labels your team uses to tag creators on Passionfroot. |
| `list_conversations` | Read | List your Passionfroot conversations with creators, most recent activity first, with unread state. |
| `list_conversation_messages` | Read | Read a Passionfroot conversation's timeline, newest first: messages, proposals with their proposalId, and posted stats. |
| `send_inquiry` | Write | Send a first sponsorship inquiry to a creator on Passionfroot, optionally for one of your campaigns. |
| `send_message` | Write | Reply to a creator in a Passionfroot conversation. |
| `mark_conversation_read` | Write | Mark a Passionfroot conversation as read for your team. |
| `accept_proposal` | Destructive | Accept a creator's proposal on Passionfroot, which books the sponsorship at the proposal's price and dates. |
| `reject_proposal` | Destructive | Reject a creator's proposal on Passionfroot, which cancels that collaboration. |

Exact input schemas come from `tools/list` once Passionfroot is connected; the free plan is enough to check.

Missing something? Your agent can ask for it with `request_feature`.

---

All integrations: https://cogny.com/integrations/tools/index.md
Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md
What Cogny is: https://cogny.com/llms.txt
