MCP Integration Guide - Connect 40+ Business Platforms to Hermes Agent¶

The CorpusIQ MCP - One OAuth, 121 Tools, 40+ Platforms¶

The biggest pain point in agent operations: managing 42 different API keys across 42 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 --auth oauth

# First create an account at https://corpusiq.io to get your MCP endpoint

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

Available Tools¶

Tool names follow the Hermes MCP convention mcp__<server>__<tool>, so every CorpusIQ tool is called as mcp__corpusiq__<name> with an action plus its parameters.

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

mcp__corpusiq__tiktok_connector
├── get_account_analytics
├── list_videos
└── get_video_analytics

# YouTube tools are top-level, not wrapped in a connector tool
mcp__corpusiq__get_my_youtube_analytics
mcp__corpusiq__get_youtube_channel
mcp__corpusiq__get_youtube_transcript
mcp__corpusiq__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 --command python --args 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 --command npx --args tsx my-server.ts

Option C: Remote HTTP MCP¶

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

Before you connect a third-party server¶

A third-party MCP server receives your credential and writes text your model treats as context. Run the ten-minute check in How to Vet an MCP Server Before You Connect It: read the tool list, probe the endpoint, inspect the OAuth discovery document, and narrow the credential before the first call.

MCP Server Monitoring¶

We run three daily monitors to discover new MCP servers:

Monitor	Sources	Schedule (America/Phoenix)
mcp-server-monitor	mcp.so, mcpservers.org	3 AM, 11 AM, 9 PM
hermes-release-monitor	GitHub releases	2 AM, 10 AM, 6 PM
skills-monitor	skills.sh	4 AM, 10 PM

New discoveries are reported to the ops email digest for evaluation.

Troubleshooting¶

"MCP server connection failed"¶

# Test connectivity
hermes mcp test corpusiq

# Check auth
hermes mcp list

# View logs
hermes logs gateway -n 50

"Tool not found"¶

# List all available tools
hermes mcp list

# Re-check which tools are enabled for the server
hermes mcp configure

"Token expired"¶

# Re-authenticate
hermes mcp reauth corpusiq

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: 40+ business platforms through ONE MCP server. No managing 42 API keys, no 42 different auth flows. One OAuth, one server, 121 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.