How to integrate Paved MCP with Hermes

Connect Hermes to Paved MCP. List your active paved sponsorship campaigns, find newsletter sponsorship opportunities for fintech, and more using natural language, with authentication handled for you.

Paved logoPaved
Api Key

Paved is an all-in-one platform for managing newsletter sponsorships. It helps publishers and advertisers find, plan, and manage sponsorship campaigns.

31 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Paved account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Paved with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Paved with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Paved

Ask your agent to connect to Paved, or simply request any Paved-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Paved connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Paved or request any Paved-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Paved MCP server, and what's possible with it?

The Paved MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Paved account. It provides structured and secure access to newsletter sponsorships, advertising campaigns, ad copy, and publisher newsletters, so your agent can find newsletters, review sponsorships, inspect campaign details, and manage ad copy information on your behalf.

  • Newsletter discovery: Have your agent list publisher newsletters with their names, URLs, slugs, and current status.
  • Publisher sponsorship tracking: Let the agent retrieve all sponsorships for a publisher newsletter or look up one specific sponsorship.
  • Advertiser sponsorship review: Direct your agent to list sponsorships associated with your advertiser account.
  • Campaign research: Instruct your agent to list ad network campaigns, with optional filters for dates or campaign status.
  • Ad copy lookup: Have your agent list the ad copies belonging to an advertiser campaign so you can review available campaign content.

Way Forward

With Paved connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Paved action and event your agent gets out of the box.

Archive Ad Network Campaign

Archive an advertiser ad network campaign.

Clone Ad Network Campaign

Clone an advertiser ad network campaign, optionally overriding its details.

Create Ad Copy

Create an ad copy in an advertiser campaign.

Create Ad Network Campaign

Create an ad network campaign with its schedule, bid, targeting, and budgets.

Create Newsletter

Create a publisher newsletter from its name and website URL.

Delete Ad Copy

Permanently delete an ad copy from an advertiser campaign; it cannot be restored by this toolkit.

Delete Ad Network Campaign

Permanently delete an ad network campaign.

Get Ad Copy

Retrieve one ad copy from an advertiser campaign.

Get Ad Copy Stats

Retrieve performance statistics for one campaign ad copy.

Get Ad Network Campaign

Retrieve one campaign, optionally with related details and date-filtered ad-copy statistics.

Get Ad Network Campaign Stats

Retrieve performance statistics for one ad network campaign.

Get Newsletter

Retrieve one publisher newsletter by slug.

Get Publisher Placement Reporting

Retrieve placement-level earnings and reporting for a newsletter.

Get Publisher Placement Reporting By Placement

Retrieve reporting for one publisher newsletter placement.

Get Publisher Sponsorship

Retrieve one sponsorship for a publisher newsletter.

List Ad Copies

List the ad copies belonging to an advertiser campaign.

List Ad Copy Stats

List performance statistics for ad copies in an advertiser campaign.

List Ad Network Campaigns

List one page of ad network campaigns, optionally filtered by date or status and with caller-selected related details.

List Advertiser Sponsorships

List sponsorships for the authenticated advertiser.

List Newsletters

List all publisher newsletters with their slug, name, URL, and status.

List Publisher Placements

List ad network placements for a publisher newsletter.

List Publisher Sponsorships

Retrieve all sponsorships for a publisher newsletter.

Replace Ad Copy

Replace supplied ad-copy fields with PUT; Paved does not document how omitted fields are handled, while explicit null clears a field.

Replace Ad Network Campaign

Replace supplied campaign fields with PUT; Paved does not document how omitted fields are handled.

Replace Newsletter

Replace a newsletter's complete required name and URL representation using PUT.

Start Ad Network Campaign

Start campaign delivery, which can accrue ad spend immediately; stopping later does not reverse accrued spend.

Stop Ad Network Campaign

Stop campaign delivery to halt future ad spend; this does not reverse spend already accrued.

Submit Ad Network Campaign

Submit a campaign only when explicitly requested; Paved does not document the resulting stage, prerequisites, or edit restrictions.

Update Ad Copy

Partially update an ad copy in an advertiser campaign.

Update Ad Network Campaign

Partially update selected mutable fields of an ad network campaign.

Update Newsletter

Update a newsletter using PATCH; Paved still requires both name and URL in this operation.

FAQ

Frequently asked questions

Start with Paved.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Paved tool your agent needs.Free to start.

Start building