How to integrate Skyfire MCP with Hermes

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

Skyfire logoSkyfire
Api Key

Skyfire is a payment infrastructure that lets AI agents transact and pay for services autonomously. It streamlines payments for AI applications, reducing manual overhead.

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

Also integrate Skyfire with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ 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 Skyfire 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 Skyfire

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

4. Done. You're all set with a new Skyfire 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 Skyfire or request any Skyfire-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The Skyfire MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Skyfire account. It provides structured and secure access to your autonomous payment and transaction infrastructure, so your agent can create tokens, pay for services, check balances, audit charges, and discover available AI-powered services on your behalf.

  • Autonomous service payments: Let your agent issue payment tokens and seamlessly pay for AI services or digital goods without manual intervention.
  • Wallet balance and charge auditing: Have your agent check buyer wallet balances before transactions and audit token charges to track exactly what was spent and when.
  • Discovery of AI and digital services: Enable your agent to browse, filter, and retrieve detailed info about available services using tags or seller agents, streamlining selection and integration.
  • Token management and automation: Allow your agent to create, manage, and charge Skyfire tokens (KYA, PAY, KYA+PAY), handling sophisticated payment flows programmatically.
  • Service details and compliance checks: Instruct your agent to fetch detailed service terms, API specs, and integration URLs—helping ensure compliance and smooth onboarding before making purchases.

Way Forward

With Skyfire 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 Skyfire action and event your agent gets out of the box.

Charge Skyfire Token

Charge a buyer's token (seller-side operation).

Create Skyfire KYA+PAY Token

Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).

Create Skyfire KYA Token

Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).

Create Skyfire PAY Token

Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).

Get All Service Tags

Fetch all service tags to discover filtering options.

Get Skyfire Buyer Wallet Balance

Retrieve buyer wallet balance.

Get Directory Service By ID

Tool to get full details for a specific service in the Skyfire directory by its ID.

Get Skyfire Service Details

Get full details for one service.

Get Services by Agent

Browse all services from one seller agent.

Get Services by Tags

Filter services by tags to find exactly what you need.

Get Skyfire Token Charges

Audit charges for a specific token.

Introspect Skyfire Token

Check if a token is still valid before calling a seller service.

List Agent Seller Services

List all services registered by the authenticated seller agent.

List Skyfire Buyer Tokens

Inspect buyer tokens for observability.

List Skyfire Directory Services

Browse Skyfire's service directory to obtain `sellerServiceId` for token creation.

Set Agent Source IP Addresses

Register IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips).

FAQ

Frequently asked questions

With a standalone Skyfire MCP server, the agents and LLMs can only access a fixed set of Skyfire tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Skyfire and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Skyfire tools.

Yes, absolutely. You can configure which Skyfire scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Skyfire data and credentials are handled as safely as possible.

Start with Skyfire.It takes 30 seconds.

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

Start building