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¶

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

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 --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
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 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.