Connect MARVIN MCP

Connection details

MARVIN exposes one production Streamable HTTP endpoint:

https://mcp.viewmarvin.com/mcp

Authenticate every request with the agency MCP token from MARVIN Settings:

Authorization: Bearer <agency MCP token>

Use the production URL above in external MCP clients. The internal /api/mcp route is handled by MARVIN and is not the endpoint you should configure.

Connect your client

1. Open MARVIN Settings and create or reveal your agency MCP token.
2. Add a remote Streamable HTTP MCP server in your AI client.
3. Set the server URL to https://mcp.viewmarvin.com/mcp.
4. Set the bearer token or Authorization header to the agency MCP token.
5. Connect and confirm the client can list MARVIN tools.
6. Start with get_clients or get_clients_overview, then drill into a client or ad account.

Available reporting tools

• get_clients and get_users
• get_meta_ad_accounts
• get_clients_overview
• get_meta_ad_accounts_overview
• get_booking_clients_performance and get_booking_agents_performance
• get_client_booking_performance and get_agent_booking_performance
• get_client_performance
• get_meta_ad_account_performance

Client overview and client performance accept an optional platformFilter: all, meta. Platform leads are a reconciliation view against GHL leads, rather than additive totals.

Google Ads is in private preview. Google account tools and the google filter are available to pilot agencies and agencies with existing Google reporting history. New Google connections are coming soon for other agencies.

Scope and safety

MARVIN MCP is read-only. The bearer token determines the agency scope, and reporting tools default to the last 30 days when dates are omitted. Date ranges cannot exceed 365 days, and large results may be truncated with row-limit metadata. Keep the token private, and revoke or replace it from Settings if it is exposed.