1. Pendo Help Center
  2. Pendo for Agents
  3. Agent Toolkit

Set up Fin in Agent Toolkit (beta)

Last updated:

This article covers how to set up an agent that runs on Intercom Fin and connect it to Pendo to unlock the capabilities it can use.

To set up a custom agent, one you build in-house or a third-party agent you configure, see Set up a custom agent in Agent Toolkit. For more information about Agent Toolkit, see Overview of Agent Toolkit.

Agent Toolkit is visible to all users in the main navigation, but only subscription admins can add and configure agents.

How it works

For a Fin by Intercom agent, you set up an agent in a single wizard with five steps:

  • Agent details. Choose whether the agent runs on Fin by Intercom or is a custom agent, name your agent, and select the apps it can access.
  • Connect MCP. Set up the MCP connection, which powers guides, session context, and feedback submission.
  • Set up proactive support. Connect your messaging platform through webhooks, which powers workflow nudges and frustration signals.
  • Sync Visitor IDs with Intercom. Enable Visitor ID syncing for the selected web apps when Pendo Visitor IDs and Intercom user IDs don't already match.
  • Review. Check your details and connections, then create the agent.

You must connect at least one of MCP or webhooks. When setup is complete, you turn on and set up individual capabilities from the agent's tabs.

Note: When you add or update an agent, Pendo prevents you from linking a service account or webhook that's already linked to another Agent Toolkit agent. Unlink it from the existing agent before linking it to a different one.

Before you begin

To set up an agent in Agent Toolkit, you need:

  • Subscription admin permissions to access Agent Toolkit. These permissions are also required to turn on MCP.
  • Webhooks turned on for your subscription. Webhooks are required if you want to set up the workflow nudge and frustration signal support for your agent.
  • An Intercom Fin workspace.
  • Verify that Visitor IDs in Pendo match user IDs in Intercom. If the IDs don't match, you can use ID syncing between Pendo and Intercom. See Sync IDs between Pendo and Intercom for instructions.

Important: If the IDs don't already match, Fin can't recognize those visitors and the agent's capabilities won't work for them. See Sync IDs between Pendo and Intercom for instructions on how to set this up, before or after creating the agent.

Step 1: Add an AI agent

To begin setting up an AI agent in Agent Toolkit, watch the video walkthrough or follow the steps below.

  1. Go to Agent Toolkit in the main navigation.
  2. Select Add agent to open the setup wizard.
  3. Under Agent type, select Intercom Fin. If the agent runs on a different platform, follow the instructions to Set up a custom agent in Agent Toolkit instead.
  4. Enter a Name for the agent and optionally a Description.
  5. Under Accessible apps, select at least one app the agent can access. This field is required. Mobile and extension apps aren't supported.
  6. Review the beta disclaimer and select the checkbox to acknowledge the beta terms. You must acknowledge the disclaimer before you can continue.
  7. Select Continue.

Step 2: Connect MCP

The MCP connection lets your agent query live Pendo data, which powers guides, session context, and feedback submission. If you don't need these capabilities, select Skip and set up webhooks instead.

The wizard walks you through the configuration in Intercom, with links that open the right Intercom pages.

Note: Turning on the MCP server enables MCP for your subscription. This means users can read and write Pendo data outside of the Pendo application. For more information, see Overview of the Pendo MCP server.

To connect MCP for your agent, watch the video walkthrough or follow the steps below.

  1. In the wizard, turn on MCP server to set up a service account so your agent can query live Pendo data through the MCP server.

  2. Under Create connection, copy the credentials the wizard displays. You paste these into Intercom in the next step:

    • OAuth token URL
    • Client ID
    • Client secret
    • Scope

    Important: Save the client secret somewhere safe. Pendo can't show it again after you leave the wizard.

  3. Select Create authentication token in Fin. This opens Intercom's authentication settings. Create a new token using the values from the wizard:

    • Type: OAuth.
    • HTTPS URL: the OAuth token URL from the wizard.
    • Client ID and Client secret: the values from the wizard.
    • Scope: read:me.
    • Request format: Form encoded.

    Test the token in Intercom to confirm it returns a 200 OK response.

  4. Save the token in Intercom. Return to the wizard and select the Authentication token created in Fin checkbox.
  5. Under Add MCP connector in the wizard, copy the MCP server URL, then select Set up in Fin. This opens Intercom's data connectors page. Locate the Custom MCP to add the Pendo MCP server. In the custom MCP view, enter the following:
    • Name: a name you'll recognize, for example, Pendo MCP.
    • URL: the MCP server URL from the wizard.
    • Authentication: select the authentication token you created in the previous step.
  6. Return to the wizard and select the MCP connector added in Fin checkbox.
  7. Select Test connection to confirm your agent can reach Pendo. Testing is recommended.
  8. Select Continue.

Tip: Adding the custom MCP data connector in Fin is easy to miss, but your agent can't reach Pendo data without it.

Step 3: Set up proactive support with webhooks

The webhook connection pushes real-time Pendo events to your agent, which powers proactive support capabilities such as workflow nudges and frustration signals. This connects your Intercom Fin workspace. If you don't need these capabilities and you've connected MCP, select Skip.

Note: If you skipped MCP, a webhook connection is required to proceed and create an agent.

To set up proactive support with webhooks, watch the video walkthrough or follow the steps below.

  1. Select Connect with Intercom to connect your Intercom workspace. This opens an authorization page in a new tab to allow Pendo Agent Toolkit to connect to Intercom.
  2. Select Authorize access. This reopens the Agent Toolkit setup wizard.
  3. In Connect Proactive Support, connect with Intercom using OAuth. Choose either:
    • Create a new connection. Create a new Intercom Fin webhook named after the agent and scoped to the agent's accessible apps from Step 1.
    • Use an existing connection. Select an existing Intercom Fin webhook with the same app scope as the agent. If none exist, you're prompted to create a new connection.

  4. Select Create connection. This creates the webhook and links to your Intercom Fin agent.

    Note: The webhook starts inactive and won't send events until you set up and turn on its capabilities (workflow nudges and frustration signals) after agent setup is complete.

  5. Select Continue.

Step 4: Sync Visitor IDs with Intercom

This step appears only for Fin by Intercom agents. Use it to turn on ID syncing for the web apps you selected, so Pendo and Intercom recognize the same visitors. If the Pendo Visitor ID and Intercom user ID already match, you can leave syncing turned off.

  1. Turn on Sync Visitor IDs with Intercom to enable syncing for the selected web apps.
  2. Select Continue.

For the full ID-syncing setup, including the steps you complete in Intercom, see Sync IDs between Pendo and Intercom.

Step 5: Review

On the Review step, confirm your agent details and connection setup. At least one of MCP or webhooks must be connected.

To review and create your agent, watch the video walkthrough or follow the steps below.

  1. Check the summary: agent type, name, apps, MCP status, and webhook status.
  2. Select Add agent.

Pendo creates the agent and opens its overview page, where you can start enabling capabilities.

Next steps

If you haven't already, complete the setup for ID syncing. See Sync IDs between Pendo and Intercom for instructions.

If you turned on the MCP-based capabilities, you can:

If you turned on the webhook-based capabilities, you can:

Was this article helpful?
0 out of 0 found this helpful

Articles in this section