> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tapti MCP Tools

> This page documents all available tools in the Tapti MCP Server. Each tool provides a set of methods for interacting with users, accounts, content, comments, demographics, and more across supported platforms.

<Info>
  All tools are available via the Tapti MCP Server. See the <a href="./overview">MCP Overview</a> for setup and configuration.
</Info>

<CardGroup cols={1}>
  <Card title="User Tools" icon="user">
    <ul>
      <li><b>getUsersByTenantApp</b>: Get users for the current tenant app based on the API key.</li>
      <li><b>getUserById</b>: Get a specific user by ID for the current tenant app.</li>
    </ul>
  </Card>

  <Card title="Account Tools" icon="users">
    <ul>
      <li><b>getUserAccounts</b>: Get user accounts for a specific user.</li>
      <li><b>refreshAccounts</b>: Refresh user accounts.</li>
    </ul>
  </Card>

  <Card title="Profile Tools" icon="id-card">
    <ul>
      <li><b>getProfiles</b>: Get profiles for specific user accounts.</li>
      <li><b>fetchProfiles</b>: Fetch profiles for a user account.</li>
    </ul>
  </Card>

  <Card title="Comments Tools" icon="comments">
    <ul>
      <li><b>getComments</b>: Get comments for a content item.</li>
      <li><b>getRecentComments</b>: Get recent comments for a user account.</li>
      <li><b>publishComment</b>: Publish a comment on a content item or content group.</li>
    </ul>
  </Card>

  <Card title="Content Tools" icon="file">
    <ul>
      <li><b>getContentsByUserAccountId</b>: Get content items for a user account.</li>
      <li><b>getContentById</b>: Get a specific content item by ID.</li>
      <li><b>publishContent</b>: Publish or schedule a new content item for a user account.</li>
    </ul>
  </Card>

  <Card title="Demographics Tools" icon="chart-pie">
    <ul>
      <li><b>getAccountDemographics</b>: Get demographics for a specific user account.</li>
      <li><b>getAudienceAgeBreakdown</b>: Get age breakdown of the audience for a user account.</li>
    </ul>
  </Card>

  <Card title="Engagement Tools" icon="gauge">
    <ul>
      <li><b>getContentEngagement</b>: Get engagement metrics for a specific content item.</li>
      <li><b>getTopPerformingContent</b>: Get top performing content for a user account.</li>
      <li><b>getAccountEngagement</b>: Get engagement metrics for a user account.</li>
      <li><b>getEngagementTrends</b>: Get engagement trend data for a user account.</li>
    </ul>
  </Card>

  <Card title="Content Groups & Items" icon="folder">
    <ul>
      <li><b>getContentGroups</b>: Get content groups for a user account.</li>
      <li><b>getContentGroupById</b>: Get a specific content group by ID.</li>
      <li><b>getContentGroupItems</b>: Get items in a content group.</li>
      <li><b>getContentGroupItemById</b>: Get a specific content group item by ID.</li>
    </ul>
  </Card>

  <Card title="OAuth Tools" icon="key">
    <ul>
      <li><b>redirectToAuth</b>: Redirects to the platform-specific OAuth authentication flow.</li>
      <li><b>handleAuthCallback</b>: Handles the callback from the OAuth authentication flow.</li>
    </ul>
  </Card>
</CardGroup>

***

## Example Usage

To call a tool, send a request to the Fusion MCP Server endpoint with the appropriate method and parameters. For example, to get all users for a tenant app:

<CodeGroup>
  ```json title="Get all users for a tenant app" theme={null}
  {
      "tool": "getUsersByTenantApp",
      "params": {}
  }
  ```
</CodeGroup>

For tools that require parameters, provide them in the `params` object:

<CodeGroup>
  ```json title="Get a user by ID" theme={null}
  {
      "tool": "getUserById",
      "params": { "user_id": "USER_ID_HERE" }
  }
  ```
</CodeGroup>

See the <a href="./overview">MCP Overview</a> for setup and server configuration details.