Sovereign marketing analytics. Claude meets your data.
Herald is a Rust MCP server that bridges Claude with Google Ads, Google Analytics 4, Search Console, and Atrium CRM. Closed-loop attribution from ad click to actual appointment. No third-party analytics wrappers, no dashboard middleware.
Claude Code <--stdio/MCP--> herald.exe <--REST API--> Google Ads
<--REST API--> Google Analytics 4
<--REST API--> Google Search Console
<--SQLite----> Atrium CRM
- MCP layer: rmcp over stdio
- Google APIs: Direct REST with OAuth2 token refresh
- Atrium: Read-only SQLite for ground-truth attribution
list_accounts- List configured ad accountslist_changes- Recent account modifications with before/after valuesget_performance- Campaign metrics (impressions, clicks, CPC, conversions, cost)get_keywords- Keyword performance with quality scoresget_search_terms- Actual search queries that triggered adsrun_query- Custom GAQL queries
get_analytics_traffic- Traffic by channelget_analytics_pages- Top pages with views and bounce rateget_analytics_conversions- Conversions by channelget_booking_call_events- Booking and call engagement eventsget_ai_referral_traffic- Traffic from AI sources (ChatGPT, Copilot, Claude, Gemini, Perplexity)run_analytics_report- Custom GA4 Data API reports
list_search_sites- List all Search Console properties available on the accountget_search_performance- Clicks, impressions, CTR, and average position by dateget_search_queries- Top ranking queries with CTR and positionget_search_pages- Top pages with search visibility metrics
get_patient_attribution- Real appointments with full source attributionget_channel_breakdown- Bookings by channel with revenueget_lead_pipeline- Leads by stage (new, contacted, booked, complete)
cargo build
herald.exe auth
Runs the OAuth2 flow for Google API access.
Create herald.toml with Google OAuth credentials, Ads developer token, and account mappings. Each account can include any combination of customer_id (Google Ads), ga4_property_id, gsc_site_url, and atrium_db — only configure what you need.
Add to your project's .mcp.json:
{
"mcpServers": {
"herald": {
"type": "stdio",
"command": "path/to/herald.exe"
}
}
}Wilderness Interactive Open License
Permission is hereby granted, free of charge, to use, copy, modify, and distribute this software for any purpose, including commercial use.
This software may NOT be:
- Sold as a standalone product
- Sold access to as a hosted service
Use for building software, building websites, automating workflows, and integrating with other tools (including commercial work) is explicitly permitted and encouraged. This software is designed to be moddable, so modifications are explicitly permitted and encouraged. Software and systems built using this tool can be sold freely.
The purpose of this license is to prevent reselling the software itself.
Built by Wilderness Interactive.