Audiense Insights MCP Server

Instructions

Implementation Reference

• src/index.ts:259-302 (registration)

  Registers the 'get-audience-content' MCP tool with description, Zod input schema, and handler function that calls getAudienceContent and formats response.

  server.tool(
      "get-audience-content",
      `Retrieves audience content engagement details for a given audience.
  
  This tool provides a detailed breakdown of the content an audience interacts with, including:
  - **Liked Content**: Popular posts, top domains, top emojis, top hashtags, top links, top media, and a word cloud.
  - **Shared Content**: Content that the audience shares, categorized similarly to liked content.
  - **Influential Content**: Content from influential accounts that impact the audience, with similar categorization.
  
  Each category contains:
  - **popularPost**: List of the most engaged posts.
  - **topDomains**: Most mentioned domains.
  - **topEmojis**: Most used emojis.
  - **topHashtags**: Most used hashtags.
  - **topLinks**: Most shared links.
  - **topMedia**: Media types shared and samples.
  - **wordcloud**: Frequently used words.`,
      {
          audience_content_id: z.string().describe("The ID of the audience content to retrieve."),
      },
      async ({ audience_content_id }) => {
          const data = await getAudienceContent(audience_content_id);
  
          if (!data) {
              return {
                  content: [
                      {
                          type: "text",
                          text: `No content found for audience ${audience_content_id}.`,
                      },
                  ],
              };
          }
  
          return {
              content: [
                  {
                      type: "text",
                      text: JSON.stringify(data, null, 2),
                  },
              ],
          };
      }
  );

• src/index.ts:279-301 (handler)

  MCP handler function for 'get-audience-content' tool that fetches data via getAudienceContent and returns formatted JSON response.

  async ({ audience_content_id }) => {
      const data = await getAudienceContent(audience_content_id);
  
      if (!data) {
          return {
              content: [
                  {
                      type: "text",
                      text: `No content found for audience ${audience_content_id}.`,
                  },
              ],
          };
      }
  
      return {
          content: [
              {
                  type: "text",
                  text: JSON.stringify(data, null, 2),
              },
          ],
      };
  }

• src/index.ts:276-278 (schema)

  Zod input schema defining the required 'audience_content_id' parameter for the tool.

  {
      audience_content_id: z.string().describe("The ID of the audience content to retrieve."),
  },

• src/audienseClient.ts:237-257 (helper)

  Helper function implementing the core API call to Audiense for retrieving audience content details using authenticated request.

   * Retrieves the relevant content that an audience engages with.
   */
  export async function getAudienceContent(audience_content_id: string): Promise<{
      createdAt: string;
      startDate: string;
      endDate: string;
      status: string;
      likedContent: any;
      sharedContent: any;
      influentialContent: any;
  } | null> {
      return makeAudienseRequest<{
          createdAt: string;
          startDate: string;
          endDate: string;
          status: string;
          likedContent: any;
          sharedContent: any;
          influentialContent: any;
      }>(`/audience_content/${audience_content_id}`);
  }