# Hypeauditor — how to use (mcp.ai)

Connect your Hypeauditor account and use 4 tools for social media marketing straight from your AI agent. Connect with your own API key. HypeAuditor provides comprehensive influencer marketing solutions, offering tools for influencer discovery, analytics, and campaign management across multiple social media platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hypeauditor?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hypeauditor_get_account_media`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hypeauditor`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hypeauditor/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hypeauditor/get/account/media` — Tool to retrieve media content of an Instagram account. Use when you need detailed post-level data and performance metrics for analysis.
  - body: { v?: string, type?: string, username: string }
- `POST https://api.mcp.ai/api/hypeauditor/get/report/instagram` — Tool to retrieve a detailed Instagram report. Use after providing username or user_id. Example: GET_REPORT_INSTAGRAM(username="nasa").
  - body: { v?: string, user_id?: string, features?: string[], username?: string }
- `POST https://api.mcp.ai/api/hypeauditor/get/report/tik/tok` — Retrieves comprehensive analytics report for a TikTok account including audience demographics, engagement metrics, content performance, follower growth, and authenticity scores. Use this to analyze Ti
  - body: { v?: string, channel: string }
- `POST https://api.mcp.ai/api/hypeauditor/search/influencers/suggester` — Tool to search for influencer social network accounts by keyword. Use when you need to find influencers matching a search term, with optional filtering by social network type.
  - body: { st?: string, exclSt?: string, search: string }

## Example prompts
- "What can I do in Hypeauditor?"
- "Show me a summary of my Hypeauditor account"

## More
- Page: https://mcp.ai/hypeauditor
- Agent spec (llms.txt): https://mcp.ai/hypeauditor/llms.txt
- Postman collection: https://mcp.ai/hypeauditor/postman.json