MCP
Viomba MCP
Documentation
Viomba MCP
Viomba MCP brings high precision human attention prediction, attention optimized creative generation (for display and social), and video attention analysis into your AI workflow. Give your assistant a creative, a URL, or a video — and get back media context specific attention performance intelligence data, heatmaps, and scored outputs without leaving your client.
Built on real gaze data
Viomba's attention predictions are powered foundational neural models trained on decade of consistently collected Tobii infrared gaze fixation data, collected from real users in real browsing environments across markets. This means *seen* and *viewtime* metrics reflect genuine ad-on-placement level fixations — not loose viewability proxies. The distinction matters: Tobii infrared separates true fixations from saccades at the measurement level, which is why Viomba numbers often differ from other attention proxy based tools.
Tools
Attention & Analytics
| Tool | Description |
|---|---|
| `viomba_creative_prediction` | Predict attention KPIs (seen %, view time) for a display ad |
| `viomba_heatmap_prediction` | Predict gaze heatmap for a display ad |
| `viomba_ad_slicer` | Slice an ad creative into timed PNG screenshots |
Creative
| Tool | Description |
|---|---|
| `viomba_generate_creative` | Start an ad creative generation job |
| `viomba_refine_creative` | Iterate on a previously generated creative |
| `viomba_check_generation` | Poll status and retrieve results |
| `viomba_get_creative` | Fetch a generated creative with full HTML |
| `viomba_list_generations` | List your creative-generation requests |
| `viomba_cancel_generation` | Cancel a pending or running creative job |
| `viomba_generate_site_map` | Generate an attention-weighted site map for a set of domains |
Video
| Tool | Description |
|---|---|
| `viomba_analyze_video` | Analyze a video for attention, audio/video events, and AVS sync score |
| `viomba_focus_prediction` | Predict visual attention heatmaps for a video ad |
| `viomba_request_upload` | Get a one-time browser upload URL for sharing a local video file |
| `viomba_check_upload` | Poll for upload completion; returns a token usable as `videoUrl` |
Meta Marketing API
Connect a Meta credential in the Viomba dashboard, then drive your real ad library from MCP.
| Tool | Description |
|---|---|
| `viomba_list_meta_credentials` | List Meta credentials connected to your Viomba account |
| `viomba_set_meta_credential` | Activate a credential for this MCP session |
| `viomba_list_meta_ad_accounts` | List Meta ad accounts accessible to the active credential |
| `viomba_list_meta_ad_creatives` | List ad creatives within a Meta ad account |
| `viomba_get_meta_creative_prediction` | Trigger or poll attention prediction for a Meta ad creative |
Usage & Account
| Tool | Description |
|---|---|
| `viomba_my_usage` | Usage stats and credit balance for your connected client |
| `viomba_history` | Paginated tool-call history |
| `viomba_request_detail` | Inspect a single historical tool call (request + result) |
| `viomba_tool_breakdown` | Per-tool call counts and latency |
| `viomba_fetch_image` | Fetch an image attachment returned by a previous tool call |
Getting Started
Add the server URL to your MCP client and connect — that's it. The OAuth flow
runs automatically on first connect. If you don't have an account yet, you'll be
guided through registration during sign-in.
Claude Desktop — open Settings → Connectors → Add connector and paste
`https://mcp.viomba.com/mcp`. The sign-in prompt opens in your browser automatically.
Cursor / VS Code — add the URL in your MCP server settings and connect.
The sign-in prompt opens in your browser automatically.
n8n — add an MCP node with URL `https://mcp.viomba.com/mcp` and select
OAuth as the credential type.
Once signed in, the connection is live and your credits are linked automatically.
Manual token (advanced)
If your client doesn't support OAuth or you need a long-lived token for
automation, you can issue a Persistent Access Token (PAT) from the
dashboard and pass it as a Bearer header:
{
"mcpServers": {
"viomba": {
"type": "streamable-http",
"url": "https://mcp.viomba.com/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
}Compatible Clients
- Claude Desktop
- Cursor
- VS Code (Copilot MCP)
- n8n
- Any client supporting MCP Streamable HTTP transport (spec 2025-11-25)
Pricing
Usage is credit-based — each tool call deducts credits from your Viomba account.
See viomba.com/pricing for rates.
Links
Frequently asked questions
What is MCP?
MCP is Viomba MCP
How do I install MCP?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is MCP open source?
Yes — it is hosted on GitHub at https://github.com/Viomba-Oy/MCP.
Related MCP tools
serversModel Context Protocol Servers
codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local
goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
UI-TARS-desktopThe Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
cogneeCognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP