MCP Server

Getting Your API Token

1. Log in to Fanpage Karma.
2. Go to Settings → API.
3. Copy your API token.

The token is used for authentication with all setup methods below.

Setup: Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Copy{
"mcpServers": {
"fanpagekarma": {
"url": "https://app.fanpagekarma.com/api/v2/mcp",
"headers": {
"Authorization": "Bearer your-api-token-here"
}
}
}
}

Restart Claude Desktop after saving the file.

Setup: Claude Code

Run the following command in your terminal:

Copyclaude mcp add --transport http fanpagekarma https://app.fanpagekarma.com/api/v2/mcp \
--header "Authorization: Bearer your-api-token-here"

Or add to your project's .mcp.json:

Copy{
"mcpServers": {
"fanpagekarma": {
"type": "http",
"url": "https://app.fanpagekarma.com/api/v2/mcp",
"headers": {
"Authorization": "Bearer your-api-token-here"
}
}
}
}

Setup: n8n

Use the MCP Client Tool node with the hosted service:

Other Clients

Any MCP-compatible client (Cursor, Windsurf, ChatGPT, custom integrations, etc.) can connect using the HTTP endpoints below.

Authentication

All requests require a Bearer token in the Authorization header:

CopyAuthorization: Bearer your-api-token-here

Endpoints

Method	Endpoint	Description
POST	/api/v2/mcp	Send messages (Streamable HTTP)
GET	/api/v2/mcp	SSE stream (requires mcp-session-id header)
DELETE	/api/v2/mcp	Close session
GET	/api/v2/mcp/sse	Establish SSE connection (legacy)
POST	/api/v2/mcp/messages	Send messages via SSE (legacy)

Most clients support Streamable HTTP. Use the SSE endpoints only if your client requires the legacy SSE transport.

Available Tools

The MCP server exposes seven tools that map to the API v2 endpoints:

Tool	Description	Parameters
list_connected_profiles	List your connected social media profiles with extended analytics	—
list_queried_profiles	List profiles queried via API in current billing period	—
list_available_metrics	List available metric keys, labels and types for a network and endpoint	networkrequired, endpointrequired
get_profile_metrics	Get profile-level metrics (followers, engagement, reach, etc.)	networkrequired, profile_idrequired, from, to, metrics
get_profile_posts	Get posts with engagement metrics	networkrequired, profile_idrequired, from, to, limit, offset
get_profile_stories	Get Instagram Stories data	profile_idrequired, from, to, limit, offset
get_profile_daily	Get daily time series for specific metrics	networkrequired, profile_idrequired, metricsrequired, from, to

Date parameters use YYYY-MM-DD format. If omitted, the last 28 days are used.
Use list_available_metrics or GET /api/v2/{network}/{endpoint}/metrics to discover available metric keys.
The get_profile_daily tool uses the /profile/daily endpoint path.

Supported Networks

The following networks are available for all profile tools:

• facebook
• instagram
• youtube
• linkedin
• tiktok
• threads
• bluesky
• pinterest

The get_profile_stories tool is only available for Instagram.

Usage Examples

Once configured, you can ask your AI assistant questions like: