AdsCove
Documentation menu

Get Started

Knowledge Base

Reference

Platforms

Chat & Agent (MCP)

Automation & Bridge

Using AdsCove in Hermes

AdsCove Product & Engineering · Last reviewed August 5, 2026

Available · MCP

Hermes loads MCP servers from ~/.hermes/config.yaml. Add AdsCove under mcp_servers with the remote URL and Authorization header, then restart Hermes so its tool registry is rebuilt.

Connection details

Everything the connection needs, in one place — copy any line into your client or your agent:

Endpoint (MCP):  https://adscove.com/api/mcp
Transport:       Streamable HTTP
Auth (recommended): OAuth 2.1 (no key needed)
Auth (fallback):    HTTP header Authorization: Bearer sk_live_your_key (only if OAuth is unavailable)
REST fallback:   POST https://adscove.com/api/v1/tools/{tool_name}   with the same Bearer header
Full catalog:    https://adscove.com/api/mcp?tools=full   (optional; default endpoint is faster and includes run_adscove_tool)
Verify tool:     list_connections   (free, read-only)

Setup steps

  1. Generate an API key on the console Keys page
  2. Edit ~/.hermes/config.yaml and add the YAML below
  3. Restart Hermes or start a fresh hermes chat session
mcp_servers:
  adscove:
    url: "https://adscove.com/api/mcp"
    headers:
      Authorization: "Bearer sk_live_your_key"
    connect_timeout: 10
    timeout: 30

Full catalog option

mcp_servers:
  adscove:
    url: "https://adscove.com/api/mcp?tools=full"
    headers:
      Authorization: "Bearer sk_live_your_key"

Or: hand it to your AI agent

Don't want to configure it yourself? Paste the block below into the AI agent you're using (Claude, Cursor, an MCP agent, etc.) — it contains everything needed to set up the connection. Replace sk_live_MY_KEY with the fallback key you generated.

Configure Hermes by editing ~/.hermes/config.yaml. Under mcp_servers, add adscove.url = https://adscove.com/api/mcp and headers.Authorization = Bearer sk_live_MY_KEY, restart Hermes, then ask it to check platform connection status. Direct tool calls use names like mcp_adscove_list_connections.

Verify

Ask Hermes: "check my platform connection status". If calling directly, use mcp_adscove_list_connections.

What you can do once connected

Check the business report, compare platform ROAS against real Shopify orders, create paused ad drafts, and submit budget changes. Direct writes need confirmation; separately enabled guardrails can only auto-pause within your limits. Try: “Which ads lost money in the last 7 days?”

Get started