Sign up

MCP

Connect to MARVIN MCP.

Give your AI client read-only access to live, agency-scoped MARVIN reporting.

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 and get_google_ad_accounts
  • get_clients_overview
  • get_meta_ad_accounts_overview and get_google_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 and get_google_ad_account_performance

Client overview and client performance accept an optional platformFilter: all,meta, or google. Meta results report native leads; Google results report total conversions, which can be fractional. Treat both as reconciliation views against GHL leads rather than additive totals.

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.