# How to integrate Crustdata MCP with Hermes ```json { "title": "How to integrate Crustdata MCP with Hermes", "toolkit": "Crustdata", "toolkit_slug": "crustdata", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/crustdata/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/crustdata/framework/hermes-agent.md", "updated_at": "2026-05-06T08:07:40.271Z" } ``` ## 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 Crustdata 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 Crustdata with - [OpenAI Agents SDK](https://composio.dev/toolkits/crustdata/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/crustdata/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/crustdata/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/crustdata/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/crustdata/framework/codex) - [OpenClaw](https://composio.dev/toolkits/crustdata/framework/openclaw) - [CLI](https://composio.dev/toolkits/crustdata/framework/cli) - [Google ADK](https://composio.dev/toolkits/crustdata/framework/google-adk) - [LangChain](https://composio.dev/toolkits/crustdata/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/crustdata/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/crustdata/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/crustdata/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/crustdata/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 Crustdata to Hermes ### Integrating Crustdata 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 Crustdata MCP server, and what's possible with it? The Crustdata MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Crustdata account. It provides structured and secure access to real-time company and people intelligence, so your agent can perform actions like lead enrichment, market research, investor portfolio analysis, and workforce trend tracking on your behalf. - Comprehensive person and company enrichment: Instantly enrich leads or companies with up-to-date details for customer profiling, data verification, or targeted outreach. - Advanced decision maker filtering: Find and analyze decision makers across organizations using complex filters, titles, and segmentation for your sales or marketing efforts. - Investor portfolio and funding milestone analysis: Retrieve in-depth investor portfolio data, analyze funding milestones, and generate reports for investment research or deal sourcing. - Workforce and job market trend insights: Fetch headcount and job listing timeseries data to track organizational growth, hiring activity, or competitive shifts in specific industries. - Social and web activity monitoring: Collect and analyze LinkedIn posts and web traffic data for any company to assess engagement, sentiment, and digital footprint for market intelligence and outreach strategies. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `CRUSTDATA_ENRICH_PERSON_SCREENER` | Enrich person screener | The screener person enrich endpoint enriches person data by providing additional information based on the given query. it allows users to retrieve detailed information about individuals, which can be useful for various purposes such as customer profiling, lead generation, or data verification. this endpoint should be used when you need to augment existing person data with additional details or verify information about a specific individual. the enrichment process draws from crustdata's extensive database and real-time data sources to provide up-to-date and comprehensive information. users can customize the response by specifying the exact fields they need, optimizing data transfer and processing. note that the availability and accuracy of enriched data may vary depending on the input provided and the information available in crustdata's systems. | | `CRUSTDATA_FETCH_HEADCOUNT_BY_FACET_TIMESERIES` | Fetch headcount by facet timeseries | Retrieves headcount data as a timeseries with faceted analysis capabilities. this endpoint allows users to fetch detailed headcount information over time, applying complex filters, pagination, and sorting. it's particularly useful for hr analytics, workforce planning, and organizational growth analysis. the endpoint supports nested logical operations in its filtering mechanism, enabling highly specific queries. users can paginate through large datasets and sort results based on multiple criteria. while powerful, this endpoint requires careful construction of the filters parameter to ensure accurate data retrieval. it should be used when detailed, time-based headcount analysis is needed, but may not be suitable for simple, non-time-series headcount queries or for real-time data needs due to its complexity. | | `CRUSTDATA_FETCH_INVESTOR_PORTFOLIO_DATA` | Fetch investor portfolio data | Retrieves comprehensive investor portfolio data from the data lab section of the crustdata api. this endpoint provides access to detailed information about investor portfolios, including investment holdings, performance metrics, and other relevant data points. it is designed to support investment analysis, portfolio management, and decision-making processes in a b2b context. the endpoint should be used when detailed investor portfolio information is required for tasks such as investment screening, performance tracking, or generating analytical reports. it's important to note that this endpoint may not provide real-time data and the frequency of updates should be verified in the api documentation. additionally, users should be aware of any data privacy and usage restrictions that may apply to the retrieved investor information. | | `CRUSTDATA_FILTER_DECISION_MAKERS_DATA` | Filter decision makers data | Filters and retrieves decision maker data from the crustdata b2b saas integration platform based on complex criteria. this endpoint allows for advanced querying of decision maker information using a combination of filters, pagination, sorting, and title-based filtering. it's designed for scenarios where specific subsets of decision maker data need to be extracted or analyzed. the endpoint supports nested logical conditions in filters, enabling highly targeted data retrieval. use this when you need to perform detailed analysis or reporting on decision makers across various organizations or industries. note that the endpoint requires careful structuring of the request body to effectively utilize its advanced filtering capabilities. | | `CRUSTDATA_POST_FUNDING_MILESTONE_TIME_SERIES_DATA` | Post funding milestone timeseries data | The fundingmilestonetimeseries endpoint retrieves time-series data related to funding milestones for companies. it allows for complex querying of funding events over time, with flexible filtering, pagination, and sorting options. this endpoint is particularly useful for analyzing funding trends, comparing company funding histories, or tracking specific funding events across multiple organizations. the data returned is based on the specified filters and can be tailored to focus on particular time ranges, funding stages, or company characteristics. while it provides comprehensive funding milestone data, it does not include detailed company information beyond what's directly related to funding events. | | `CRUSTDATA_POST_HEADCOUNT_TIMESERIES_DATA` | Post headcount timeseries data | Retrieves filtered and sorted headcount timeseries data from the crustdata data lab. this endpoint allows for complex querying of historical headcount information, enabling users to analyze workforce trends over time. it supports advanced filtering with nested conditions, pagination for handling large datasets, and customizable sorting. ideal for generating reports, conducting workforce analysis, or integrating headcount data into third-party business intelligence tools. note that the specifics of the returned data structure are not provided in the given schema. | | `CRUSTDATA_POST_JOB_LISTINGS_TABLE_DATA` | Post job listings table data | This endpoint retrieves filtered and sorted job listings data for specified company tickers from a chosen dataset in the crustdata platform. it allows for highly customizable queries with complex filtering conditions, pagination, and sorting options. the endpoint is designed for bulk data retrieval and analysis of job market trends across multiple companies. use this endpoint when you need to fetch and analyze job listing data for specific companies, apply custom filters to narrow down the results, or when you want to paginate through large sets of job data. it's particularly useful for market research, competitive analysis, or tracking employment trends in specific industries or companies. note that this endpoint requires careful construction of the request body, especially for the filters parameter, which can support nested logical conditions. the performance and response time may vary depending on the complexity of the filters and the amount of data requested. | | `CRUSTDATA_POST_WEB_TRAFFIC_DATA` | Post web traffic data | Retrieves filtered and sorted web traffic data from the crustdata platform. this endpoint allows for complex querying of web traffic information using nested conditions and logical operators. it supports pagination for handling large datasets and provides sorting capabilities for customized data presentation. use this endpoint when you need to analyze web traffic patterns, filter data based on specific criteria, or extract insights from your web analytics. the endpoint is particularly useful for generating reports, identifying trends, or monitoring key performance indicators related to web traffic. | | `CRUSTDATA_RETRIEVE_LINKED_IN_POSTS` | Retrieve linkedin posts | Retrieves linkedin posts for a specified company using crustdata's screener functionality. this endpoint allows users to gather social media data from linkedin, which can be used for analyzing company activity, engagement, and sentiment. it's particularly useful for b2b marketers, sales professionals, and analysts who need insights into a company's social media presence and content strategy. the endpoint supports filtering by date range and customizing the response fields, making it versatile for various use cases such as competitive analysis, lead generation, and market research. note that the availability and completeness of data may depend on the company's linkedin activity and privacy settings. | | `CRUSTDATA_SCREENER_COMPANY_INFORMATION` | Screener company information | The getcompanyscreener endpoint allows users to search and filter companies based on various criteria such as headcount, growth rate, funding, and more. it provides a powerful way to identify specific companies that meet predefined conditions. this endpoint is particularly useful for tasks like lead generation, market research, and competitive analysis. the endpoint returns a list of companies matching the specified criteria, with each company entry containing key information such as name, industry, headcount, funding details, and growth metrics. users can customize their search using multiple filters, sort the results, and paginate through large result sets. note that the accuracy of the data depends on crustdata's real-time data collection and update frequency. | | `CRUSTDATA_SCREEN_METRICS_AND_FILTER_CONDITIONS` | Screen metrics and filter conditions | The screendata endpoint enables advanced data screening and filtering on the crustdata platform. it allows users to construct complex queries for retrieving specific datasets based on custom metrics, filtering conditions, and sorting criteria. use this endpoint for targeted data extraction, custom reporting, or data analysis within the b2b saas integration ecosystem. note that while powerful, complex queries may impact performance with large datasets. | | `CRUSTDATA_SEARCH_COMPANIES_WITH_FILTERS` | Search companies with filters | The companysearch endpoint enables users to search and filter companies using the crustdata api. it provides a powerful mechanism for querying company data based on multiple criteria, supporting complex filtering and pagination. this endpoint is ideal for applications that need to retrieve specific sets of company information, such as financial analysis tools, market research platforms, or business intelligence systems. the search functionality allows for precise data retrieval, enhancing the efficiency of data integration and analysis processes in b2b scenarios. users should be aware that the endpoint requires careful construction of filter objects and proper use of pagination to ensure optimal performance and accurate results. | | `CRUSTDATA_SEARCH_FOR_JOB_ID_IN_SCREENER` | Search for job id in screener | The screener person search endpoint allows users to search for persons associated with a specific job id within the crustdata b2b saas integration platform. this post request accepts a json payload containing a job id and returns relevant person data linked to that job. it's particularly useful for scenarios where you need to quickly retrieve all individuals connected to a particular job or project. the endpoint is part of the platform's screening functionality, enabling efficient filtering of person records based on job-related criteria. while it provides a focused search based on job id, it may not offer advanced filtering options or return comprehensive job details. | | `CRUSTDATA_SEARCH_LINKED_IN_POSTS_BY_KEYWORD` | Search linkedin posts by keyword | This endpoint enables searching for linkedin posts using a specific keyword. it allows users to retrieve relevant content from linkedin by specifying a search term, along with options for pagination, sorting, and filtering by post date. the function is particularly useful for conducting market research, competitor analysis, or tracking industry trends on the linkedin platform. users can fine-tune their search results by choosing how to sort the posts (by relevance or date) and selecting a specific time frame for the content. the endpoint returns paginated results, allowing for efficient navigation through large sets of matching posts. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Crustdata MCP server provides comprehensive access to Crustdata operations through Composio. Once connected, Hermes can perform all major Crustdata actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### Way Forward With Crustdata 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 Crustdata MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/crustdata/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/crustdata/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/crustdata/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/crustdata/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/crustdata/framework/codex) - [OpenClaw](https://composio.dev/toolkits/crustdata/framework/openclaw) - [CLI](https://composio.dev/toolkits/crustdata/framework/cli) - [Google ADK](https://composio.dev/toolkits/crustdata/framework/google-adk) - [LangChain](https://composio.dev/toolkits/crustdata/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/crustdata/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/crustdata/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/crustdata/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/crustdata/framework/crew-ai) ## Related Toolkits - [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing. - [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages. - [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections. - [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach. - [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease. - [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic. - [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns. - [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active. - [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place. - [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES. - [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere. - [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools. - [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools. - [Cardly](https://composio.dev/toolkits/cardly) - Cardly is a platform for creating and sending personalized direct mail to customers. It helps businesses break through the digital clutter by getting real engagement via physical mailboxes. - [ClickSend](https://composio.dev/toolkits/clicksend) - ClickSend is a cloud-based SMS and email marketing platform for businesses. It streamlines communication by enabling quick message delivery and contact management. - [Curated](https://composio.dev/toolkits/curated) - Curated is a platform for collecting, curating, and publishing newsletters. It streamlines content aggregation and distribution for creators and teams. - [Customerio](https://composio.dev/toolkits/customerio) - Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience. - [Cutt ly](https://composio.dev/toolkits/cutt_ly) - Cutt.ly is a URL shortening service for managing and analyzing links. Streamline your workflows with quick, trackable, and branded short URLs. - [Demio](https://composio.dev/toolkits/demio) - Demio is webinar software built for marketers, offering both live and automated sessions with interactive features. It helps teams engage audiences and optimize lead generation through detailed analytics. - [Doppler marketing automation](https://composio.dev/toolkits/doppler_marketing_automation) - Doppler marketing automation is a platform for creating, sending, and tracking email campaigns. It helps you automate marketing workflows and manage subscriber lists for better engagement. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Crustdata MCP? With a standalone Crustdata MCP server, the agents and LLMs can only access a fixed set of Crustdata tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Crustdata 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 Crustdata tools. ### Can I manage the permissions and scopes for Crustdata while using Tool Router? Yes, absolutely. You can configure which Crustdata 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 Crustdata data and credentials are handled as safely as possible. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)