integrations tools passionfroot

    Passionfroot MCP for your AI agent

    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.

    • 9readonly reads data.
    • 3writecreates or changes something.
    • 2destructivedeletes, 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. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect Passionfroot in Cogny. Every Passionfroot tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    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.

    what each tool does.

    Read 9 · only reads data

    • get_sponsorship_summaryReadSee 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_placementsReadList your sponsored placements on Passionfroot with date, status, platform, link, reported views, likes, comments and shares, and price.
    • list_collaborationsReadList your sponsorship deals with creators on Passionfroot: status, price, campaign and when they changed.
    • get_collaborationReadGet one sponsorship deal on Passionfroot with its status, price and campaign.
    • list_creatorsReadList the creators you've worked with on Passionfroot, with your private notes and labels, and optionally their channels and audience metrics.
    • get_creatorReadGet one creator you've worked with on Passionfroot: country, your notes and labels, and their channels with audience metrics.
    • list_creator_labelsReadList the labels your team uses to tag creators on Passionfroot.
    • list_conversationsReadList your Passionfroot conversations with creators, most recent activity first, with unread state.
    • list_conversation_messagesReadRead a Passionfroot conversation's timeline, newest first: messages, proposals with their proposalId, and posted stats.

    Write 3 · creates or changes something

    • send_inquiryWriteSend a first sponsorship inquiry to a creator on Passionfroot, optionally for one of your campaigns.
    • send_messageWriteReply to a creator in a Passionfroot conversation.
    • mark_conversation_readWriteMark a Passionfroot conversation as read for your team.

    Destructive 2 · deletes, removes or replaces something

    • accept_proposalDestructiveAccept a creator's proposal on Passionfroot, which books the sponsorship at the proposal's price and dates.
    • reject_proposalDestructiveReject 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.