How to Use the Reportei MCP in Claude

Q: How do I connect Reportei to Claude Desktop?

Open your claudedesktopconfig.json file and add the Reportei MCP configuration under the mcpServers key. Once you save the file and restart Claude Desktop, the application will load the tools automatically. You will see the hammer icon in your chat window, indicating the tools are ready to use.

Q: Can I use Claude Desktop to run a Reportei report?

Yes, your agent can trigger the createreport tool to generate a new report inside your account. Claude Desktop will then use getreportdetails to retrieve the final URL and share it with you in the chat.

Q: How do I view Reportei timeline events in Claude Desktop?

You can ask Claude Desktop to list past events by calling listreporteitimeline for a specific project. If you want to add a new milestone, like a budget change or a campaign launch, the agent can run addreporteievent to write it directly to the client's timeline.

Fetch live marketing metrics and build reports right inside Claude Desktop without bouncing between browser tabs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Reportei MCP to Claude Desktop

Create your Vinkius account to connect Reportei to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Reportei with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Instant client reporting from the chat window

Stop manually exporting CSVs from Facebook and Google. When you plug this MCP Server into your Claude Desktop app, your agent gets direct access to your client lists and active campaigns. Just tell Claude to check on a client, and it runs `list_clients` to find the target and `get_client` to pull their specific details. You do not have to copy-paste Facebook data into a slide deck anymore. Claude can call `create_report` directly in the chat to spin up a fresh performance doc. It uses your active Google and Facebook integration tokens to fetch the latest numbers, saving you from the weekly reporting grind.

Deep dive into live marketing metrics with Claude Desktop

Sometimes a basic PDF report is not enough, and you need to look at raw performance numbers. This MCP connection lets Claude Desktop execute `get_reportei_metrics` to grab specific data points from your active channels. Your agent reads the raw Facebook and Instagram numbers and explains the performance trends directly in your Claude chat interface. If you need to trace what happened over a specific period, Claude can check `list_reportei_timeline` to see the historical log. It is a faster way to prepare for a client sync without logging into three different ad managers like Facebook or Google.

Audit active ad integrations and projects

Keep track of which client accounts are actually connected to your reporting stack. Your agent can run `list_integrations` to verify your Facebook, Instagram, and Google connections are still active and authorized. If a Facebook token expires, Claude will let you know before you try to build a report. Claude can also fetch your internal structure by calling `list_reportei_projects` to map out your workspaces. This keeps your Reportei workspace organized and ensures your Claude agent pulls data from the correct project folder every single time.

Setup guide

Set up Reportei MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Reportei MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Reportei MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under reportei-mcp.

json

{
  "mcpServers": {
    "reportei-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Reportei. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Reportei now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Reportei MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the Reportei MCP configuration under the `mcpServers` key. Once you save the file and restart Claude Desktop, the application will load the tools automatically. You will see the hammer icon in your chat window, indicating the tools are ready to use.

Yes, your agent can trigger the `create_report` tool to generate a new report inside your account. Claude Desktop will then use `get_report_details` to retrieve the final URL and share it with you in the chat.

You can ask Claude Desktop to list past events by calling `list_reportei_timeline` for a specific project. If you want to add a new milestone, like a budget change or a campaign launch, the agent can run `add_reportei_event` to write it directly to the client's timeline.

Yes, you can ask your agent to find specific documents. Claude will run `list_reportei_reports` and pass the project ID to narrow down the results, showing you only the relevant performance data for that specific brand.

The server acts as a secure bridge, passing your Google, Facebook, and Instagram marketing metrics directly to Claude Desktop via encrypted local transport. Your raw credentials and client lists are never stored on external third-party servers, keeping your agency's data fully isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript