Connect OwlStat to AI Assistants

Query your Instagram analytics with natural language. Ask about stats, compare accounts, generate reports — all from your favorite AI tool.

Claude Claude Code Cursor Codex ChatGPT

What you can do

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

How is @nike performing this month?
Compare @nike vs @adidas vs @puma on engagement
Generate a monthly report for @clientname
What's the best time to post for @brand?
Which content type works best for @influencer?

Available tools

Account Stats

Followers, engagement rate, growth, reach

Top Posts

Best performing content ranked by metric

Compare Accounts

Side-by-side competitor benchmarking

Hashtag Analysis

Which hashtags drive engagement

Audience Insights

Growth trajectory and account health

Generate Report

Full analytics report with recommendations

Best Posting Times

When to post for max engagement

Content Breakdown

Performance by type: Reel, Carousel, Image

Reels Analytics

Viral velocity, shares, and view metrics

Post Insights

Track reach, saves, shares over time

Growth Summary

Follower projections and trends

Manage Workspace

Add or remove tracked accounts

Monitored Accounts

List all accounts in your workspace

Viral Studio Overview

Cross-platform short-form video stats

Viral Studio Recommendations

AI coaching for short-form content

Before you start

1. You need an OwlStat account with at least one tracked Instagram account.
2. Find your API key in OwlStat Settings under the API section.

Choose your AI tool

Select your AI assistant below for specific setup instructions.

🧠

Claude Desktop Recommended

Anthropic's desktop app for Mac & Windows
1

Open Connectors settings

In Claude, go to Settings → Connectors → Add Custom Connector, or open this direct link.

2

Configure the connector

Fill in the following fields:

  • Name: OwlStat
  • URL: https://mcp.owlstat.io/mcp
  • Authentication: Select API Key, then paste your key from OwlStat Settings
3

Try it out

Start a new conversation. You should see the OwlStat tools available. Try asking:

Show me the stats for @nike over the last 30 days
No install required. Connectors are built into Claude — no config files, no Node.js, no extra dependencies.
💻

Claude Code Recommended

Anthropic's CLI for the terminal
1

Add the server with one command

Run this in your terminal. Replace YOUR_API_KEY with your key:

claude mcp add owlstat \
  --transport sse \
  -h "Authorization: Bearer YOUR_API_KEY" \
  --scope user \
  https://mcp.owlstat.io/sse

The --scope user flag makes it available in every project.

2

Verify it's connected

Start a new Claude Code session and type:

/mcp

You should see owlstat listed with its tools.

3

Try it out

Compare @nike vs @adidas on engagement this month
To remove later: claude mcp remove owlstat --scope user
📝

Cursor

AI-powered code editor
1

Open Cursor Settings

Go to Cursor Settings → MCP Servers (or open ~/.cursor/mcp.json).

2

Add OwlStat

Replace YOUR_API_KEY with your key from OwlStat Settings:

{
  "mcpServers": {
    "owlstat": {
      "type": "sse",
      "url": "https://mcp.owlstat.io/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
3

Restart Cursor

Restart the app. The OwlStat tools will appear when you use the AI chat panel.

🤖

OpenAI Codex CLI

OpenAI's terminal agent
1

Configure Codex

Replace YOUR_API_KEY with your key. Add to ~/.codex/config.yaml:

mcp_servers:
  owlstat:
    type: sse
    url: https://mcp.owlstat.io/sse?apiKey=YOUR_API_KEY

Or use the inline flag:

codex --mcp-server "owlstat=https://mcp.owlstat.io/sse?apiKey=YOUR_API_KEY"
2

Try it out

Show me the stats for @nike over the last 30 days
💬

ChatGPT Advanced

Via custom GPT actions
1

Create a custom GPT

In ChatGPT, go to Explore GPTs → Create and add an MCP action pointing to:

https://mcp.owlstat.io/sse?apiKey=YOUR_API_KEY

Replace YOUR_API_KEY with your key from OwlStat Settings.

Note: ChatGPT's MCP support is newer and may require additional configuration depending on your ChatGPT plan.

Troubleshooting

Server not appearing

Make sure you fully restarted your AI tool after editing the config. Most tools don't hot-reload MCP servers.

Authentication errors (401)

Double-check your API key in OwlStat Settings. Copy-paste it — don't type manually.

"Account not found" errors

The Instagram account needs to be tracked in your OwlStat workspace first. Add it through the OwlStat dashboard, then try again.

Need help?

Contact us at [email protected] or open a chat on owlstat.io.