Skip to content
YNTYOU NEED THIS™

Agent integrations

WHAT ASSISTANTS CAN DO.

Connect an assistant such as ChatGPT or Claude to your account. It signs in as you and approves the connection first, so it only ever sees your own discoveries and your own business campaigns.

Connection address

https://yyouneedthis.com/mcp

Add this address in your assistant. It will open a YOU NEED THIS™ approval screen where you sign in, or create an account, and choose Approve or Deny.

  • Search discoveries

    search_discoveries

    Find live discoveries by keyword or city, with teaser copy, slug and campaign code.

    Access: Published discoveries only — never drafts or unpublished campaigns.

    Inputs

    • query (text) optional

      Words to match in title or teaser.

    • city (text) optional

      Limit to a targeted city.

    • limit (number 1–50) optional

      Results to return, default 10.

    Example request

    {
  "name": "search_discoveries",
  "arguments": { "query": "dinner", "city": "Austin", "limit": 5 }
}

  • List saved discoveries

    list_saved_discoveries

    Read the user's saved, need this, maybe later and offers collections.

    Access: Only the connected user's own collections.

    Inputs

    • collection (saved | need_this | maybe_later | offers) optional

      Limit to a single collection; omit for all.

    Example request

    {
  "name": "list_saved_discoveries",
  "arguments": { "collection": "need_this" }
}

  • Save or remove a discovery

    save_discovery

    Add a discovery to a collection, or remove it with save set to false.

    Access: Writes only to the connected user's own collections.

    Inputs

    • slug (text) required

      Discovery slug from a search result.

    • collection (saved | need_this | maybe_later | offers) required

      Collection to change.

    • save (true / false) optional

      Default true; false removes.

    Example request

    {
  "name": "save_discovery",
  "arguments": { "slug": "midnight-tasting-menu", "collection": "saved", "save": true }
}

  • List my campaigns

    list_my_campaigns

    Campaign list with status, type, heat score, exposure tier and paid run dates.

    Access: Only campaigns owned by businesses the connected user belongs to.

    Inputs

    • status (text) optional

      Filter, e.g. draft, submitted, live, paused.

    • limit (number 1–100) optional

      Results to return, default 25.

    Example request

    {
  "name": "list_my_campaigns",
  "arguments": { "status": "live", "limit": 10 }
}

  • Get campaign performance

    get_campaign_performance

    Scan, reveal, lead and conversion counts for one campaign.

    Access: Only campaigns owned by businesses the connected user belongs to.

    Inputs

    • slug (text) optional

      Campaign slug (or use campaignCode).

    • campaignCode (text) optional

      Campaign code, e.g. DINE02.

    Example request

    {
  "name": "get_campaign_performance",
  "arguments": { "campaignCode": "DINE02" }
}

When something fails

Every action answers with the same shape: a short sentence, a code, and a reference number you can quote to support. No record data or account details are ever written to logs.

  • unauthenticated

    The agent has no approved connection for a signed-in user.

  • invalid_input

    A required value was missing or out of range.

  • not_found

    Nothing matching is available to that account.

  • forbidden

    The account does not have access to that record.

  • upstream_error

    The data service refused or failed the request.

  • internal_error

    Unexpected failure; the reference code appears in the log.