# How to integrate Aviato MCP with Hermes

```json
{
  "title": "How to integrate Aviato MCP with Hermes",
  "toolkit": "Aviato",
  "toolkit_slug": "aviato",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/aviato/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/aviato/framework/hermes-agent.md",
  "updated_at": "2026-11-05T05:31:24.042Z"
}
```

## 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 Aviato 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 Aviato with

- [ChatGPT](https://composio.dev/toolkits/aviato/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/aviato/framework/claude-cowork)
- [Atomic Agent](https://composio.dev/toolkits/aviato/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 Aviato to Hermes

### Integrating Aviato 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 Aviato MCP server, and what's possible with it?

The Aviato MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Aviato account. It provides structured and secure access to company and person intelligence, so your agent can search profiles, enrich business and professional data, research relationships and investments, and discover contact details on your behalf.
- Company and people research: Have your agent search companies, people, and locations, then filter results using profile, employment, education, and geographic criteria.
- Detailed profile enrichment: Let the agent gather company identity, industries, headcount, products, jobs, financials, legal details, social metrics, web traffic, and supported person information.
- Relationships and investment analysis: Direct your agent to investigate founders, employees, acquisitions, funding rounds, inbound and outbound investments, fund investments, and personal vesting records.
- Contact discovery: Instruct your agent to retrieve available email and phone records for people, reveal stored email addresses, or match personal email addresses using their hashes.
- Market maps and data exports: Have your agent generate and check similar-company market maps, review available exports, access export files, and check the connected team's Aviato credit balance.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `AVIATO_BULK_ENRICH_COMPANIES` | Bulk Enrich Companies | Enrich one to 100 companies in one request. Successful lookups may consume credits; there is no documented preview mode, and unmet require gates are returned unsuccessful without billing. |
| `AVIATO_BULK_ENRICH_PEOPLE` | Bulk Enrich People | Enrich one to 20 people in one request. Preview mode returns minimal identification data without charging; preview=false may consume credits, and unmet require gates are returned unsuccessful without billing. Email lookup identifiers and returned profile data can be sensitive. |
| `AVIATO_BULK_REVEAL_PERSON_EMAILS` | Bulk Reveal Person Emails | Reveal stored email records for one to 100 people. This returns sensitive personal contact data and is potentially billable: Aviato charges only when contact data is found. It does not verify contact data. Provider prose mentions phones, but the formal response exposes emails only, so this action does not claim phone support. The contradictory email field accepts both addresses and the provider's documented context example values. |
| `AVIATO_ENRICH_COMPANY` | Enrich Company | Look up one company's general profile, including identity, URLs, industries, headcount, products, jobs, and available relationship data. Use the focused financial, legal, social-metrics, or web-traffic tools when only one of those categories is needed. Preview mode returns minimal identity data without charging; preview=false may consume credits, and unmet require gates return 404 without a charge. |
| `AVIATO_ENRICH_COMPANY_FINANCIALS` | Enrich Company Financials | Get a company's financial information, including funding, market data, and estimated annual revenue. Available category data may consume credits; Aviato documents that a 404 for unavailable category data or an unmet require gate is not charged. |
| `AVIATO_ENRICH_COMPANY_LEGAL` | Enrich Company Legal Data | Get a company's legal identifiers and registered name. Available category data may consume credits; Aviato documents that a 404 for unavailable category data or an unmet require gate is not charged. |
| `AVIATO_ENRICH_COMPANY_SOCIAL_METRICS` | Enrich Company Social Metrics | Get a company's social audience counts, history, and growth metrics. Available category data may consume credits; Aviato documents that a 404 for unavailable category data or an unmet require gate is not charged. |
| `AVIATO_ENRICH_COMPANY_WEB_TRAFFIC` | Enrich Company Web Traffic | Get a company's web traffic history, sources, and visitor geography. Available category data may consume credits; Aviato documents that a 404 for unavailable category data or an unmet require gate is not charged. |
| `AVIATO_ENRICH_PERSON` | Enrich Person | Look up one person by a supported identifier. Preview mode returns minimal identity data without charging; preview=false may consume credits, and unmet require gates return 404 without a charge. Person identifiers and returned profile data can be sensitive. |
| `AVIATO_FILTER_PEOPLE` | Filter People | Filter people with predefined profile, location, education, and employment fields, one page at a time. Enrichment is off by default; when enabled, it costs exactly 1 person credit per result. Aviato does not document the base search as free. Results contain person profile data that can be sensitive. At most 15 searches may run concurrently per customer across all API keys and company and person search operations. |
| `AVIATO_GENERATE_MARKET_MAP` | Generate Market Map | Start asynchronous generation of a similar-company market map. This potentially billable call starts work immediately, and Aviato documents no cancel, delete, or other teardown endpoint, so the work cannot be undone through the API. The returned map ID must be checked separately with Get Market Map. |
| `AVIATO_GET_CREDIT_BALANCE` | Get Credit Balance | Return the connected Aviato team's current credit balance and, when available, its balance immediately after the latest top-up. The provider does not explicitly guarantee that this call is non-charging. |
| `AVIATO_GET_EXPORT_CHUNK_DOWNLOAD_URL` | Get Export Chunk Download URL | Mint a short-lived presigned URL for exactly one Aviato export chunk without fetching it. The URL is sensitive bearer-like data: treat it as a secret, return it only to the authorized caller, and never fetch it automatically. |
| `AVIATO_GET_EXPORT_DOWNLOAD_URLS` | Get Export Download URLs | Mint one short-lived presigned URL per matching chunk in an Aviato export without fetching any URL. The URLs are sensitive bearer-like data: treat them as secrets, return them only to the authorized caller, and never fetch them automatically. |
| `AVIATO_GET_IMAGE_TOKEN` | Get Image Token | Generate a token for loading company or person images from Aviato's image servers. The returned token is sensitive: use it only for the intended image request, return it only to the authorized caller, and do not expose it in logs or unrelated user-visible output. |
| `AVIATO_GET_MARKET_MAP` | Get Market Map | Poll one supplied Aviato market map ID once. Return its pending, error, or complete status and any available similar-company categories. This action does not wait or poll repeatedly. |
| `AVIATO_GET_PERSON_CONTACT_INFO` | Get Person Contact Info | Call Aviato's generic contact-info compatibility endpoint for one person's stored email records. Prefer REVEAL_PERSON_EMAILS for an explicit email-only intent; this separate tool exists to map the provider's distinct live path. It returns sensitive personal data, may consume credits, and does not verify address ownership or deliverability. |
| `AVIATO_GET_PERSON_EMAIL_HASHES` | Get Person Email Hashes | Return SHA-256 hashes of one person's personal email addresses for matching. This is not email verification and does not prove ownership, deliverability, or validity. Hashes remain sensitive linkable identifiers, and the call may consume Aviato credits. |
| `AVIATO_LIST_COMPANY_ACQUISITIONS` | List Company Acquisitions | Return one page of companies acquired by a company. This relationship read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_COMPANY_EMPLOYEES` | List Company Employees | Return one page of employees and work history for a company. The operation may consume Aviato credits and returns potentially sensitive person profile data. |
| `AVIATO_LIST_COMPANY_FOUNDERS` | List Company Founders | Return one page of a company's founders. This may consume Aviato credits and returns potentially sensitive person profile data. |
| `AVIATO_LIST_COMPANY_FUNDING_ROUNDS` | List Company Funding Rounds | Return one page of a company's equity financing rounds and their company or person investors. Person-linked financial relationships can be sensitive and require an authorized purpose. This read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_COMPANY_FUND_INVESTMENTS` | List Company Fund Investments | Return one page of investment fund vehicles in which a company invested, including available company and person investor relationships. Person-linked financial data can be sensitive and requires an authorized purpose. This read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_COMPANY_INBOUND_INVESTMENTS` | List Company Inbound Investments | Return one page of investments made into a company, including available company or person investor details. Person-linked financial relationships can be sensitive and require an authorized purpose. This read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_COMPANY_OUTBOUND_INVESTMENTS` | List Company Outbound Investments | Return one page of investments a company made into other companies. This financial relationship read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_COMPANY_RAISED_FUNDS` | List Company Raised Funds | Return one page of named investment fund vehicles raised by a company, with amount, date, and available company or person investors; these are not the company's equity financing rounds. Person-linked financial data can be sensitive. This read may consume Aviato credits; exact cost is undocumented. |
| `AVIATO_LIST_EXPORT_CHUNKS` | List Export Chunks | List all chunk names in one Aviato export, optionally filtered by team, table, or deletion state. Chunk names can identify sensitive export contents; this endpoint does not mint URLs or download data. |
| `AVIATO_LIST_EXPORTS` | List Exports | List all data-export metadata available to the connected Aviato account or selected team. Export metadata can identify sensitive datasets; this endpoint does not return or download export contents. |
| `AVIATO_LIST_PERSON_COMPANY_INVESTMENTS` | List Person Company Investments | Return one page of companies in which a person invested, with documented investment details. Each page may consume Aviato credits and contains sensitive person-related financial and relationship data. |
| `AVIATO_LIST_PERSON_FOUNDED_COMPANIES` | List Person Founded Companies | Return one page of companies founded by a person. Each page may consume Aviato credits; exact cost is undocumented. Person identifiers and returned relationship data can be sensitive. |
| `AVIATO_LIST_PERSON_FUND_INVESTMENTS` | List Person Fund Investments | Return one page of funds in which a person invested. Each page may consume Aviato credits and contains sensitive person-related financial and relationship data. |
| `AVIATO_LIST_PERSON_VESTINGS` | List Person Vestings | Return one page of a person's vesting records. Each page may consume Aviato credits and contains highly sensitive equity and compensation estimates; use and retain them only for an authorized purpose. |
| `AVIATO_REVEAL_PERSON_EMAILS` | Reveal Person Emails | Use Aviato's explicit email endpoint to reveal stored email records for one person, optionally filtered by personal, work, or student context. Prefer this for email-only discovery; GET_PERSON_CONTACT_INFO maps the provider's generic compatibility path. This returns sensitive personal contact data, is potentially billable, and does not verify deliverability or ownership. The provider's formal email field is contradictory, so the response accepts both addresses and its documented context example values. |
| `AVIATO_REVEAL_PERSON_PHONES` | Reveal Person Phones | Reveal stored phone records for one person. This returns sensitive personal contact data, is potentially billable, and does not verify a phone number. The score is source-recency confidence rather than verification. |
| `AVIATO_SEARCH_COMPANIES` | Search Companies | Search companies with Aviato's JSON DSL and return one bounded page. This request may consume Aviato credits; exact pricing is undocumented. Filters must be provider DSL expressions, not natural-language instructions. At most 15 searches may run concurrently per customer across all API keys and company and person search operations. |
| `AVIATO_SEARCH_LOCATIONS` | Search Locations | Find Aviato geocoded location IDs for company or person search filters. Aviato does not document a billing guarantee or price for this call. |
| `AVIATO_SEARCH_PEOPLE` | Search People | Search people with Aviato's JSON DSL and return one bounded page. This request may consume Aviato credits; exact pricing is undocumented. name_query is broad and tokenized, not exact, and filters must be provider DSL expressions rather than natural-language instructions. Results contain person profile data that can be sensitive. At most 15 searches may run concurrently per customer across all API keys and company and person search operations. |

## Supported Triggers

None listed.

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

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

## Complete Code

None listed.

## Conclusion

### Way Forward
With Aviato 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 Aviato MCP Agent with another framework

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

## Related Toolkits

- [HubSpot](https://composio.dev/toolkits/hubspot) - HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place.
- [Pipedrive](https://composio.dev/toolkits/pipedrive) - Pipedrive is a sales management platform offering pipeline visualization, lead tracking, and workflow automation. It helps sales teams keep deals moving forward efficiently and never miss a follow-up.
- [Salesforce](https://composio.dev/toolkits/salesforce) - Salesforce is a leading CRM platform that helps businesses manage sales, service, and marketing. It centralizes customer data, enabling teams to drive growth and build strong relationships.
- [Apollo](https://composio.dev/toolkits/apollo) - Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.
- [Attio](https://composio.dev/toolkits/attio) - Attio is a customizable CRM and workspace for managing your team's relationships and workflows. It helps teams organize contacts, automate tasks, and collaborate more efficiently.
- [Acculynx](https://composio.dev/toolkits/acculynx) - AccuLynx is a cloud-based roofing business management software for contractors. It streamlines project tracking, lead management, and document sharing.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Affinity](https://composio.dev/toolkits/affinity) - Affinity is a relationship intelligence CRM that helps private capital investors find, manage, and close more deals. It streamlines deal flow and surfaces key connections to help you win opportunities.
- [Agencyzoom](https://composio.dev/toolkits/agencyzoom) - AgencyZoom is a sales and performance platform built for P&C insurance agencies. It helps agents boost sales, retain clients, and analyze producer results in one place.
- [Agile CRM](https://composio.dev/toolkits/agile_crm) - Agile CRM is a unified customer management platform combining contacts, sales pipelines, marketing, and support. Use it to centralize customer data, automate campaigns, and manage deals and tickets in one place.
- [Bettercontact](https://composio.dev/toolkits/bettercontact) - Bettercontact is a smart contact enrichment tool for finding emails and phone numbers. It helps boost lead generation with automated, waterfall search across multiple sources.
- [Blackbaud](https://composio.dev/toolkits/blackbaud) - Blackbaud provides cloud-based software for nonprofits, schools, and healthcare institutions. It streamlines fundraising, donor management, and mission-driven operations.
- [Blitz API](https://composio.dev/toolkits/blitz_api) - Blitz API is a people, company, and job search API with contact and company enrichment. Use it to enrich leads and accelerate sales outreach with accurate contact and firmographic data.
- [Brilliant directories](https://composio.dev/toolkits/brilliant_directories) - Brilliant Directories is an all-in-one platform for building and managing online membership communities and business directories. It streamlines listings, member management, and engagement tools into a single, easy interface.
- [Capsule crm](https://composio.dev/toolkits/capsule_crm) - Capsule CRM is a user-friendly CRM platform for managing contacts and sales pipelines. It helps businesses organize relationships and streamline their sales process efficiently.
- [Centralstationcrm](https://composio.dev/toolkits/centralstationcrm) - CentralStationCRM is an easy-to-use CRM software focused on collaboration and long-term customer relationships. It helps teams manage contacts, deals, and communications all in one place.
- [Clarify MCP](https://composio.dev/toolkits/clarify_mcp) - Clarify MCP is a CRM platform for managing companies, people, deals, meetings, tasks, lists, and campaigns. Use it to centralize CRM data and streamline sales and marketing workflows.
- [Clay](https://composio.dev/toolkits/clay) - Clay is a go-to-market data enrichment and workflow automation platform for searching people and companies, running routines, and querying workspace tables. It helps teams enrich leads, automate GTM workflows, and keep workspace data synchronized.
- [Clay MCP](https://composio.dev/toolkits/clay_mcp) - Clay MCP is a prospect enrichment service for researching companies and contacts. It runs enrichment providers and Clay functions to return enriched prospect data.
- [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.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Aviato MCP?

With a standalone Aviato MCP server, the agents and LLMs can only access a fixed set of Aviato tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Aviato 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 Aviato tools.

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

Yes, absolutely. You can configure which Aviato 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 Aviato data and credentials are handled as safely as possible.

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