# How to integrate Coinbase Agents MCP with Hermes

```json
{
  "title": "How to integrate Coinbase Agents MCP with Hermes",
  "toolkit": "Coinbase Agents MCP",
  "toolkit_slug": "coinbase_agents_mcp",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/coinbase_agents_mcp/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/coinbase_agents_mcp/framework/hermes-agent.md",
  "updated_at": "2026-09-29T05:34:22.206Z"
}
```

## 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 Coinbase Agents 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 Coinbase Agents MCP with

- [ChatGPT](https://composio.dev/toolkits/coinbase_agents_mcp/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/coinbase_agents_mcp/framework/claude-cowork)
- [Atomic Agent](https://composio.dev/toolkits/coinbase_agents_mcp/framework/atomic-agent)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,500+ 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.

## Connect Coinbase Agents MCP to Hermes

### Integrating Coinbase Agents 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
```

## What is the Coinbase Agents MCP server, and what's possible with it?

The Coinbase Agents MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Coinbase Agents account. It provides structured and secure access so your agent can perform Coinbase Agents operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `COINBASE_AGENTS_MCP_COINBASE_BALANCE` | Coinbase balance | Returns account balances for exactly one portfolio. If portfolio_id is omitted, only the default portfolio is returned. Results are not aggregated across portfolios; use coinbase_portfolios_list and query each portfolio for a complete multi-portfolio view. The response portfolio_id identifies the effective portfolio queried. Balances show available funds and amounts on hold; available_balance excludes funds held by open orders. Use before trading or transferring to confirm available funds. (4 fields, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_CONVERT_EXECUTE` | Coinbase convert execute | Executes a previously quoted conversion using the quote_id from convert_quote. This moves funds at the quoted rate — get a fresh quote first since quotes expire. The from/to currencies must match the original quote. (3 fields, 3 required) |
| `COINBASE_AGENTS_MCP_COINBASE_CONVERT_GET` | Coinbase convert get | Check status of a conversion by quote ID. (3 fields, 3 required) |
| `COINBASE_AGENTS_MCP_COINBASE_CONVERT_QUOTE` | Coinbase convert quote | Quotes stablecoin↔fiat and stablecoin↔stablecoin conversions, returning rate, fees, and a quote ID. It does not support BTC, ETH, or other non-stablecoin assets; use an order to trade those assets. Pass the ID to convert_execute promptly because quotes expire. (3 fields, 3 required) |
| `COINBASE_AGENTS_MCP_COINBASE_FEES` | Coinbase fees | Fee tier, maker/taker rates, and 30-day volume. (1 field, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_CANCEL` | Coinbase orders cancel | Cancels one or more open orders by ID. Removes resting orders from the book so reserved funds are released; already-filled portions are unaffected. Returns per-order success so a partial batch can fail. (1 field, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_CLOSE_POSITION` | Coinbase orders close position | Places a market order to flatten an open position for a product, moving funds immediately. Omit size for a full close or set it for a partial close. Preview the equivalent order first if fee or slippage impact matters. (3 fields, 2 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_CREATE` | Coinbase orders create | Place a market, limit, stop_limit, bracket, twap, or scaled order, subject to venue eligibility. Equities: use market or limit. Spot brackets require SELL; for entry, use market/limit BUY with attached exits. Futures brackets support BUY/SELL. Bracket stops become aggressive limit exits; fills and loss limits are not guaranteed. TWAP requires base_size, start_time, end_time, and a positive limit_price; slice count is automatic. Use orders_preview for optional fee, fill, and execution-plan estimates. Set exactly one size: limit and market SELL convert quote_size to base_size; market BUY spends quote_size; stop_limit/bracket/twap/scaled require base_size. Attached exits require market/limit parents and activate as the parent fills, including partial fills. If a FUTURE order is rejected for account eligibility, direct the user to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply. (24 fields, 3 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_EDIT` | Coinbase orders edit | Atomically update an open order's price or size without cancelling. Omit attached fields to keep existing exits. Attach or change exits only on eligible unfilled limit orders: spot BUY or futures BUY/SELL, not equities. Exits activate as the parent fills, including partial fills. Stops become aggressive limit exits; fills and loss limits are not guaranteed. Attached updates replace both legs: send attached_take_profit_price and attached_stop_loss_price to keep both, even when changing one. Read orders_get first: attached_order_configuration.trigger_bracket_gtc.limit_price maps to attached_take_profit_price; stop_trigger_price maps to attached_stop_loss_price. cancel_attached_order removes both legs, but may be rejected after an exit activates. (6 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_EDIT_PREVIEW` | Coinbase orders edit preview | Estimate the result, fees, fill price, and slippage of changing an open order's size or limit price without editing it. Hosted OAuth requires mcp:orders:create. CDP API-key callers may use rat#view where supported. Unsupported replacements return errors. (3 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_FILLS` | Coinbase orders fills | Lists individual trade executions with commissions and maker/taker indicator, filterable by product, order, side, and time range. Use this to reconcile actual fill prices and fees paid. For EQUITY fills, product_id is TICKER-QUOTE (e.g. AAPL-USD), the same form orders_create expects. (8 fields, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_GET` | Coinbase orders get | Retrieves the full status and fill details of a single order by ID. Use after creating an order to confirm execution, and before orders_edit to see the current attached take-profit/stop-loss (attached_order_id / attached_order_configuration). For EQUITY orders, product_id is TICKER-QUOTE (e.g. AAPL-USD), the same form orders_create expects. (1 field, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_LIST` | Coinbase orders list | Lists orders with optional filters by status, product, side, and time range. Use status=OPEN to find resting orders that can be edited or cancelled. For EQUITY orders, product_id is TICKER-QUOTE (e.g. AAPL-USD), the same form orders_create expects. (9 fields, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_ORDERS_PREVIEW` | Coinbase orders preview | Estimate fees, fill price, slippage, and execution plans without placing an order. Optional before orders_create; the same order-type and asset-class restrictions apply. Futures previews also estimate margin, leverage, and liquidation impact: compare current and projected margin ratios and liquidation buffers. If a FUTURE preview is rejected for account eligibility, direct the user to https://help.coinbase.com/en/coinbase/trading-and-funding/derivatives/futures-intro to apply. (23 fields, 3 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_CREATE` | Coinbase portfolios create | Creates a new named portfolio for segregating funds and positions. Does not move any funds; use transfer afterward to fund it. (1 field, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_DELETE` | Coinbase portfolios delete | Permanently deletes a portfolio. The portfolio must be empty first — transfer out any remaining funds and close all positions before deleting. The DEFAULT portfolio cannot be deleted. (1 field, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_EDIT` | Coinbase portfolios edit | Renames an existing portfolio. Does not affect balances or positions. (2 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_GET` | Coinbase portfolios get | Returns portfolio metadata, balances, and positions. (2 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PORTFOLIOS_LIST` | Coinbase portfolios list | Lists all portfolios on the account, including their UUIDs and types. Use this to find the portfolio_id needed for orders, transfers, and balance queries. (1 field, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_BEST_BID_ASK` | Coinbase products best bid ask | Returns best bid and ask for one or more products in a single call. Omit product_ids to return pricebooks for all products. Not currently available for equities. (1 field, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_BOOK` | Coinbase products book | Returns the current bid/ask order book for a product. Use to gauge available liquidity and likely slippage before sizing a market order. Not currently available for equities. (2 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_CANDLES` | Coinbase products candles | Returns historical OHLCV candles for a product at a chosen granularity and time range. Use for price history and technical analysis. Not currently available for equities. (5 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_GET` | Coinbase products get | Viewing a product, including a FUTURE one, doesn't require any special account approval. Trading it is a separate matter — see the product_type field description. (1 field, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_LIST` | Coinbase products list | Viewing products, including FUTURE ones, doesn't require any special account approval. Trading them is a separate matter — see the product_type field description. (5 fields, 0 required) |
| `COINBASE_AGENTS_MCP_COINBASE_PRODUCTS_TICKER` | Coinbase products ticker | Returns recent trade prints plus the current best bid/ask for a product. Use for a quick spot-price snapshot before previewing or placing an order. Not currently available for equities. (2 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_TRANSFER` | Coinbase transfer | Moves funds of a single currency from one portfolio to another. This executes immediately and moves money — verify the source has sufficient available balance first. Both portfolio UUIDs come from portfolios_list. (4 fields, 4 required) |
| `COINBASE_AGENTS_MCP_COINBASE_X402_FETCH` | Coinbase x402 fetch | Fetches a resource returned by x402_resources. On a 402 challenge, pays from the caller's custodial Base USDC via a pre-authorized hold, then retries with PAYMENT-SIGNATURE — no manual challenge handling. All currently supported x402 purchases through this connector use Base USDC, and max_amount uses its 6-decimal atomic units; for example, "50000" means "0.05 USDC". This tool accepts only resource URLs returned by x402_resources. max_amount is the spend control; when the user has requested the data or stated a budget, proceed in a single call rather than re-confirming. Protocol v2 only; v1 challenges are rejected. (6 fields, 1 required) |
| `COINBASE_AGENTS_MCP_COINBASE_X402_PAY` | Coinbase x402 pay | Turns an x402 PaymentRequirements challenge into a ready-to-send payment header by placing a pre-authorized hold on the caller's Base USDC balance (EIP-3009 exact scheme, v0). All currently supported x402 purchases through this connector use Base USDC, and amount and max_amount use its 6-decimal atomic units; for example, "50000" means "0.05 USDC". Attach the returned header as X-PAYMENT for v1 or PAYMENT-SIGNATURE for v2. This authorizes moving funds up to max_amount — pass the smallest amount that satisfies the requirement. Funds-touching and gated internal-only behind a default-off feature flag. (12 fields, 7 required) |
| `COINBASE_AGENTS_MCP_COINBASE_X402_RESOURCES` | Coinbase x402 resources | Discover curated x402 resources: paid on-chain and market metrics, wallet and entity intelligence, and derivatives data. Discovery spends nothing. An optional keyword q filters the catalog; omit it to list all. Each result carries the resource URL, its advisory price, and its input and output schemas. All currently supported x402 purchases through this connector use Base USDC. accepts[].amount and coinbase_x402_fetch's max_amount use USDC's 6-decimal atomic units; for example, "50000" means "0.05 USDC". A result's inputSchema is coinbase_x402_fetch's input verbatim: pass those properties flat; do not build an HTTP envelope. The live 402 challenge sets the exact amount. (1 field, 0 required) |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Coinbase Agents MCP server provides comprehensive access to Coinbase Agents operations through Composio. Once connected, Hermes can perform all major Coinbase Agents actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With Coinbase Agents 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](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build Coinbase Agents MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/coinbase_agents_mcp/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/coinbase_agents_mcp/framework/claude-cowork)
- [Atomic Agent](https://composio.dev/toolkits/coinbase_agents_mcp/framework/atomic-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Cashfree Payments MCP](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree Payments MCP is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clarity AI MCP](https://composio.dev/toolkits/clarity_ai_mcp) - Clarity AI MCP is an MCP toolkit for simulating SFDR 2.0 fund classifications from a fund name, ISIN, or CUSIP. Use it to tap Clarity AI disclosure data and modeling without building custom sustainability-data workflows.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinbase Wallet MCP](https://composio.dev/toolkits/coinbase_wallet_mcp) - Coinbase Wallet MCP is Coinbase's wallet service for interacting with onchain accounts. Use it to give agents secure, structured access to inspect wallets and request onchain actions.
- [Coinranking](https://composio.dev/toolkits/coinranking) - Coinranking is a comprehensive cryptocurrency market data platform offering access to real-time coin prices, market caps, and historical data. Get accurate, up-to-date stats for thousands of digital assets in one place.
- [Coupa](https://composio.dev/toolkits/coupa) - Coupa is a business spend management platform for procurement, invoicing, and expenses. It helps organizations streamline purchasing, control costs, and gain complete visibility over financial operations.
- [CurrencyScoop](https://composio.dev/toolkits/currencyscoop) - CurrencyScoop is a developer-friendly API for real-time and historical currency exchange rates. Easily access fiat and crypto data for smart, up-to-date financial applications.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Coinbase Agents MCP?

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

### Can I use Tool Router MCP with Hermes?

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 Coinbase Agents tools.

### Can I manage the permissions and scopes for Coinbase Agents while using Tool Router?

Yes, absolutely. You can configure which Coinbase Agents 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.

### How safe is my data with Composio Tool Router?

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 Coinbase Agents data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)