The Heritage Foundation

Streamable HTTP MCP ยท Marketo REST API

Marketo person subscriptions and activity data

A Streamable HTTP MCP server for inspecting Marketo person records, subscriber fields, and person-level activity history through approved read-only tools.

Endpoints

Ways to connect

Microsoft Copilot Studio

Use API key authentication with a single request header.

Server URL: https://marketo-rest-mcp.heritagemcp.org/mcp
Authentication: API key
Location: Header
Header name: X-Marketo-Credentials
Value: <base64url JSON credential payload>

Bearer-token MCP clients

Use this mode for clients that provide a bearer authorization value.

Authorization: Bearer <base64url JSON credential payload>

Separate request headers

Use this mode for MCP clients that support multiple custom headers.

X-Marketo-Client-Id: <client id>
X-Marketo-Client-Secret: <client secret>
X-Marketo-Munchkin-Id: <munchkin id>
X-MCP-API-Key: <mcp server api key>

Available MCP tools (9)

These are the tools currently exposed through MCP service discovery.

People resolution

  • marketo_lookup_person_by_email
  • marketo_find_people
  • marketo_get_person_by_id

Subscription data

  • marketo_find_subscription_fields
  • marketo_get_person_subscriptions
  • marketo_lookup_person_subscriptions_by_email

Activity data

  • marketo_get_activity_types
  • marketo_get_person_recent_activities
  • marketo_count_person_activities

Subscription workflow

  1. Resolve the person by email, name, or lead ID.
  2. Discover subscriber/subscription fields for the Marketo instance.
  3. Read those fields for the selected lead ID.

Activity workflow

  1. Resolve the person by email, name, or lead ID.
  2. Optionally resolve activity type names.
  3. Retrieve or count activity records for that lead ID.

Credential note

The Worker does not store Marketo credentials. MCP clients send credentials with each request using one of the supported connection modes above.

Use npm run make:credential-token to generate the base64url credential payload for Copilot Studio or bearer-token clients.