# How to integrate Btcpay server MCP with Hermes ```json { "title": "How to integrate Btcpay server MCP with Hermes", "toolkit": "Btcpay server", "toolkit_slug": "btcpay_server", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/btcpay_server/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/btcpay_server/framework/hermes-agent.md", "updated_at": "2026-05-06T08:04:16.831Z" } ``` ## 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 Btcpay server 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 Btcpay server with - [OpenAI Agents SDK](https://composio.dev/toolkits/btcpay_server/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/btcpay_server/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/btcpay_server/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/btcpay_server/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/btcpay_server/framework/codex) - [OpenClaw](https://composio.dev/toolkits/btcpay_server/framework/openclaw) - [CLI](https://composio.dev/toolkits/btcpay_server/framework/cli) - [Google ADK](https://composio.dev/toolkits/btcpay_server/framework/google-adk) - [LangChain](https://composio.dev/toolkits/btcpay_server/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/btcpay_server/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/btcpay_server/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/btcpay_server/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/btcpay_server/framework/crew-ai) ## TL;DR ### 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. ## Connect Btcpay server to Hermes ### Integrating Btcpay server 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 Btcpay server MCP server, and what's possible with it? The Btcpay server MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Btcpay server account. It provides structured and secure access to your Bitcoin payment infrastructure, so your agent can perform actions like creating payment requests, managing stores, handling API keys, and automating webhooks on your behalf. - Automated payment request creation: Instruct your agent to generate new payment requests for your stores, making it simple to accept Bitcoin payments from customers without manual setup. - Store management and provisioning: Let your agent create, configure, or remove stores in your Btcpay server environment to support multiple business units or projects. - API key administration: Ask your agent to list, retrieve, or revoke API keys, streamlining secure access control for developers and integrations. - Webhook registration for event automation: Enable your agent to register webhooks, so you can receive instant notifications or trigger workflows when key payment or store events occur. - User and payout management: Have the agent create new server users programmatically or delete store payouts that are no longer needed, giving you granular control over your payment operations. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `BTCPAY_SERVER_CREATE_PAYMENT_REQUEST` | Create Payment Request | Tool to create a new payment request for a store. use after confirming store id. | | `BTCPAY_SERVER_CREATE_STORE` | Create Store | Tool to create a new store in btcpay server. use when you need to provision a new store before processing transactions. | | `BTCPAY_SERVER_CREATE_USER` | Create BTCPay Server User | Tool to create a new btcpay server user. use when you need to register a new user programmatically as an administrator. | | `BTCPAY_SERVER_CREATE_WEBHOOK` | Register a Webhook | Tool to register a new webhook. use when you need to receive store event notifications. | | `BTCPAY_SERVER_DELETE_API_KEY` | Delete API Key | Tool to revoke a specific api key. use when you need to remove an api key to immediately prevent its use. call after identifying the key to revoke. | | `BTCPAY_SERVER_DELETE_PAYMENT_REQUEST` | Delete Payment Request | Tool to delete a specific payment request. use when you need to archive/remove an existing payment request for a store. | | `BTCPAY_SERVER_DELETE_PAYOUT` | Delete Store Payout | Tool to delete a specific payout from a store. use when you need to cancel a payout no longer needed. | | `BTCPAY_SERVER_GET_API_KEY` | Get API Key | Tool to retrieve the current api key. use after authentication to get api key details. | | `BTCPAY_SERVER_GET_API_KEYS` | List API Keys | Tool to list api keys. use when you need to retrieve all api keys associated with the authenticated user. | | `BTCPAY_SERVER_GET_PAYMENT_REQUESTS` | Get Payment Requests | Tool to list all payment requests for a specific store. use after confirming you have the store id. | | `BTCPAY_SERVER_GET_SERVER_INFO` | Get BTCPay Server Info | Tool to retrieve information about the btcpay server instance. use when needing server version, tor address, supported payment methods, and synchronization states. | | `BTCPAY_SERVER_GET_STORE` | Get Store | Tool to retrieve information about a specific store. use when you need full store configuration. | | `BTCPAY_SERVER_GET_USER` | Get BTCPay Server User | Tool to retrieve information about a specific user. use when you need to fetch profile data for a given user id or email. | | `BTCPAY_SERVER_GET_WEBHOOK` | Get Store Webhook | Tool to retrieve details of a specific webhook. use when you need to verify the configuration or status of a webhook for a given store after its creation. | | `BTCPAY_SERVER_GET_WEBHOOKS` | List Store Webhooks | Tool to list all webhooks registered for a store. use when you need to retrieve the configured webhooks for management or auditing. | | `BTCPAY_SERVER_LIST_APPS` | List Apps | Tool to list all apps associated with a specific store. use when retrieving basic metadata of every app in that store. | | `BTCPAY_SERVER_UPDATE_USER` | Update BTCPay Server User | Tool to update current user information. use when you need to modify your authenticated user profile on btcpay server. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Btcpay server MCP server provides comprehensive access to Btcpay server operations through Composio. Once connected, Hermes can perform all major Btcpay server actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### Way Forward With Btcpay server 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 Btcpay server MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/btcpay_server/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/btcpay_server/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/btcpay_server/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/btcpay_server/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/btcpay_server/framework/codex) - [OpenClaw](https://composio.dev/toolkits/btcpay_server/framework/openclaw) - [CLI](https://composio.dev/toolkits/btcpay_server/framework/cli) - [Google ADK](https://composio.dev/toolkits/btcpay_server/framework/google-adk) - [LangChain](https://composio.dev/toolkits/btcpay_server/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/btcpay_server/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/btcpay_server/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/btcpay_server/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/btcpay_server/framework/crew-ai) ## Related Toolkits - [Addresszen](https://composio.dev/toolkits/addresszen) - Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation. - [Asin data api](https://composio.dev/toolkits/asin_data_api) - Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights. - [Baselinker](https://composio.dev/toolkits/baselinker) - BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations. - [Bestbuy](https://composio.dev/toolkits/bestbuy) - Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making. - [Cdr platform](https://composio.dev/toolkits/cdr_platform) - Cdr platform is an API for purchasing carbon dioxide removal services. It enables businesses to offset emissions by accessing verified carbon removal projects. - [Cloudcart](https://composio.dev/toolkits/cloudcart) - CloudCart is an e-commerce platform for building and managing online stores. It helps businesses streamline product listings, orders, and customer engagement. - [Countdown api](https://composio.dev/toolkits/countdown_api) - Countdown API gives you real-time, structured eBay product data, reviews, and seller feedback. Perfect for powering price monitoring, product research, or marketplace analytics workflows. - [Dpd2](https://composio.dev/toolkits/dpd2) - Dpd2 is a robust email management platform for handling, sorting, and automating email workflows. Streamline your communications and boost productivity with advanced sorting, labeling, and response tools. - [Finerworks](https://composio.dev/toolkits/finerworks) - FinerWorks is an online platform for fine art and photo printing services. Artists and photographers use it to order custom prints and manage print inventory efficiently. - [Fingertip](https://composio.dev/toolkits/fingertip) - Fingertip is a business management platform for selling, booking, and customer engagement—all from a single link. It helps businesses streamline operations and connect with customers across social channels. - [Fraudlabs pro](https://composio.dev/toolkits/fraudlabs_pro) - FraudLabs Pro is an online payment fraud detection service for e-commerce and merchants. It helps minimize chargebacks and revenue loss by detecting and preventing fraudulent transactions. - [Gift up](https://composio.dev/toolkits/gift_up) - Gift Up! is a digital platform for selling, managing, and redeeming gift cards online. It streamlines promotions and gift card transactions for businesses and their customers. - [Goody](https://composio.dev/toolkits/goody) - Goody is a gifting platform that lets users send gifts and physical products without handling logistics. It streamlines gifting by managing delivery, fulfillment, and recipient experience. - [Gumroad](https://composio.dev/toolkits/gumroad) - Gumroad is a platform for selling digital products, physical goods, and memberships with a simple checkout and marketing tools. It streamlines creator payouts and helps you grow your audience effortlessly. - [Instacart](https://composio.dev/toolkits/instacart) - Instacart is an online grocery delivery and pickup service platform. It lets you discover local retailers and create shoppable lists and recipes with ease. - [Junglescout](https://composio.dev/toolkits/junglescout) - Junglescout is an Amazon product research and analytics platform for sellers. It delivers sales estimates, competitive insights, and optimization tools to boost your Amazon business. - [Ko fi](https://composio.dev/toolkits/ko_fi) - Ko-fi is a platform that lets creators receive donations, memberships, and sales from fans. It helps creators monetize their work and grow their audience with minimal friction. - [Lemon squeezy](https://composio.dev/toolkits/lemon_squeezy) - Lemon Squeezy is a payments and subscription platform built for software companies. It makes managing payments, taxes, and customer subscriptions effortless. - [Loyverse](https://composio.dev/toolkits/loyverse) - Loyverse is a point-of-sale (POS) platform for small businesses, offering tools for sales, inventory, and customer loyalty. It helps streamline retail operations and boost customer engagement. - [Memberstack](https://composio.dev/toolkits/memberstack) - Memberstack lets you add user authentication, payments, and member management to your website—no backend code required. Easily manage your site's members and subscriptions from a single platform. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Btcpay server MCP? With a standalone Btcpay server MCP server, the agents and LLMs can only access a fixed set of Btcpay server tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Btcpay server 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 Btcpay server tools. ### Can I manage the permissions and scopes for Btcpay server while using Tool Router? Yes, absolutely. You can configure which Btcpay server 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 Btcpay server data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)