Skip to content

MCP Integration Guide -- Connect 37+ Business Platforms to Hermes Agent

The CorpusIQ MCP -- One OAuth, 53 Tools, 37+ Platforms

The biggest pain point in agent operations: managing 37 different API keys across 37 different platforms. The CorpusIQ MCP server solves this with a single OAuth flow.

Quick Start

# Add to Hermes
hermes mcp add corpusiq -- url https://mcp2.corpusiq.io/mcp

> 👉 First create an account at [corpusiq.io](https://corpusiq.io) to get your MCP endpoint

# Authenticate (device login flow)
hermes mcp auth corpusiq
# → Opens browser: Enter code "ABCD-1234"
# → Authenticate with Google
# → Done. 53 tools available.

Available Tools

CRM & Sales

mcp_corpusiq_crm_connector
├── list_hubspot_contacts
├── search_hubspot_contacts
├── list_hubspot_deals
├── get_hubspot_contact
├── list_leadconnector_contacts
├── get_leadconnector_opportunity
├── close_list_leads (Close CRM)
├── activecampaign_get_contacts
└── odoo_search_partners

Analytics & SEO

mcp_corpusiq_ga4_connector
├── list_properties
├── run_report (dimensions + metrics + date ranges)
└── get_realtime

mcp_corpusiq_ahrefs_connector
├── get_domain_overview
├── get_organic_keywords
├── get_backlinks_overview
└── get_competitors

mcp_corpusiq_semrush_connector
├── get_domain_overview
├── get_organic_keywords
├── get_paid_keywords
└── get_keyword_overview

mcp_corpusiq_search_console_connector
├── get_sites
├── get_performance
└── inspect_url

mcp_corpusiq_posthog_connector
├── list_events
├── list_persons
├── run_query (HogQL)
└── get_funnel

Email & Marketing

mcp_corpusiq_email_connector
├── list_gmail_messages
├── search_gmail
└── get_gmail_message

mcp_corpusiq_klaviyo_connector
├── get_campaigns
├── get_email_metrics_summary
├── get_flows
└── get_campaign_revenue

mcp_corpusiq_mailchimp_connector
├── get_campaigns
├── get_lists
├── get_campaign_report
└── search_members

Advertising

mcp_corpusiq_google_ads_connector
├── get_account_summary
├── list_campaigns
├── get_keyword_performance
└── get_search_terms

mcp_corpusiq_meta_ads_connector
├── get_facebook_account_insights
├── list_facebook_campaigns
├── get_facebook_campaign_insights
└── get_instagram_account_insights

mcp_corpusiq_linkedin_ads_connector
├── get_account_info
├── list_ad_accounts
├── list_campaigns
└── get_campaign_analytics

Ecommerce & Payments

mcp_corpusiq_stripe_connector
├── get_account
├── list_charges
├── list_customers
├── list_payouts
└── get_balance

mcp_corpusiq_amazon_seller_connector
├── list_amazon_orders
├── get_amazon_sales_metrics
└── list_amazon_inventory

mcp_corpusiq_ebay_connector
├── get_orders
├── get_seller_performance_overview
└── get_traffic_report

Finance

mcp_corpusiq_quickbooks_connector
├── get_profit_loss
├── list_invoices
├── get_balance_sheet
├── get_overdue_invoices
└── get_ar_aging

Social & Content

mcp_corpusiq_tiktok_connector
├── get_account_analytics
├── list_videos
└── get_video_analytics

mcp_corpusiq_youtube_connector
├── get_my_youtube_analytics
├── get_youtube_transcript
└── search_youtube

mcp_corpusiq_slack_connector
├── list_channels
├── search_messages
└── get_workspace_analytics

Storage & Productivity

mcp_corpusiq_drive_connector
├── search_drive (Google Drive)
├── list_my_onedrive_files
├── search_my_dropbox
└── read_sheet

mcp_corpusiq_notion_connector
├── notion_search
├── notion_query_database
└── notion_get_page

mcp_corpusiq_calendar_connector
├── list_my_calendar_events
├── list_my_outlook_events
└── search_my_calendar

Database Direct

mcp_corpusiq_database_connector
├── query_database (PostgreSQL/MSSQL)
├── list_database_tables
├── query_cosmos_database
└── list_cosmos_containers

Query Patterns

Cross-Source Analysis

The real power comes from querying across platforms in a single session:

# "How did our Meta ads perform vs Shopify revenue this week?"

# 1. Get ad spend
meta_ads = mcp_corpusiq_meta_ads_connector(
    action="get_facebook_account_insights",
    params={"start_date": "2026-06-09", "end_date": "2026-06-15"}
)

# 2. Get revenue (via cross-source connector)
roas = mcp_corpusiq_cross_source_ads_connector(
    action="correlate_spend_vs_ga4_revenue",
    params={"customer_id": "...", "property_id": "..."}
)

# 3. Get email attribution
email = mcp_corpusiq_cross_source_email_connector(
    action="get_channel_attribution_summary"
)

Automated Reporting

# "Generate a weekly business health report"

# 1. Revenue
profit_loss = mcp_corpusiq_quickbooks_connector(action="get_profit_loss")
stripe = mcp_corpusiq_stripe_connector(action="get_balance")

# 2. Traffic
ga4 = mcp_corpusiq_ga4_connector(action="run_report", params={
    "property_id": "...",
    "dimensions": ["date"],
    "metrics": ["sessions", "activeUsers", "conversions"],
    "date_ranges": [{"start_date": "7daysAgo", "end_date": "today"}]
})

# 3. Email
klaviyo = mcp_corpusiq_klaviyo_connector(action="get_email_metrics_summary")

# 4. SEO
ahrefs = mcp_corpusiq_ahrefs_connector(action="get_domain_overview", params={"domain": "corpusiq.io"})

Adding Your Own MCP Server

Option A: FastMCP (Python)

# my_server.py
from fastmcp import FastMCP

mcp = FastMCP("My Server")

@mcp.tool()
def get_dashboard_metrics():
    """Return key business metrics"""
    return {"mrr": 12500, "users": 843, "churn": 0.02}

mcp.run()

hermes mcp add my-server -- python my_server.py

Option B: TypeScript

// my-server.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const server = new McpServer({ name: "my-server" });

server.tool("get_metrics", async () => ({
  content: [{ type: "text", text: JSON.stringify({ mrr: 12500 }) }]
}));

hermes mcp add my-server -- npx tsx my-server.ts

Option C: Remote HTTP MCP

hermes mcp add remote-server -- url https://my-mcp-server.com/sse

MCP Server Monitoring

We run three daily monitors to discover new MCP servers:

Monitor Sources Schedule
mcp-server-monitor mcp.so, mcpservers.org 3 AM, 11 AM, 7 PM
hermes-release-monitor GitHub releases 2 AM, 10 AM, 6 PM
skills-monitor skills.sh 4 AM, 12 PM, 8 PM

New discoveries are reported to Telegram Topic 2 for evaluation.

Troubleshooting

"MCP server connection failed"

# Test connectivity
hermes mcp test corpusiq

# Check auth
hermes mcp auth corpusiq --check

# View logs
journalctl --user -u hermes-gateway -n 50 | grep mcp

"Tool not found"

# List all available tools
hermes mcp list

# Reload MCP config
hermes mcp reload

"Token expired"

# Re-authenticate
hermes mcp auth corpusiq --reauth

Architecture Note

MCP servers run as subprocesses managed by Hermes. Each server:

  • stdio transport: Local, zero-latency, no network dependency (recommended for custom servers)
  • HTTP transport: Remote, supports OAuth, good for shared servers (CorpusIQ, Honcho)
  • Tool registration: Automatic -- Hermes discovers tools on connect

The CorpusIQ advantage: 37+ business platforms through ONE MCP server. No managing 37 API keys, no 37 different auth flows. One OAuth, one server, 53 tools.

*

This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.

All Pages