How to integrate Identitycheck MCP with Hermes

GET STARTED FOR FREE
Identitycheck logo
Hermes logo
divider

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 Identitycheck 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 Identitycheck 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 Identitycheck 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 Identitycheck

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

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

5. Done!

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

The Identitycheck MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Identitycheck account. It provides structured and secure access to your verification workflows, so your agent can perform actions like checking onboarding status, fetching document content, managing notification endpoints, and retrieving configurations on your behalf.

  • Instant onboarding status checks: Your agent can retrieve and monitor the progress or result of any onboarding process, keeping you updated in real time.
  • Document content retrieval: Effortlessly fetch base64-encoded document content tied to a specific onboarding and document code for further analysis or archiving.
  • Comprehensive configuration management: List, fetch, or delete identity verification configurations, giving you full control over your Identitycheck setup without manual dashboard work.
  • Notification endpoint oversight: List, fetch, or remove notification endpoints to customize how and where you receive verification event updates.
  • API health monitoring: Quickly verify API availability before performing operations, ensuring reliability and uptime for your verification workflows.

Supported Tools & Triggers

Tools
Check API HealthTool to perform API health check.
Delete configurationTool to delete an existing configuration.
Delete Notification EndpointTool to delete a notification endpoint.
Fetch All ConfigurationsTool to fetch all existing configurations.
Fetch all notification endpointsTool to fetch all notification endpoints.
Fetch ConfigurationTool to fetch a configuration by its code.
Fetch Notification EndpointTool to fetch a notification endpoint by its code.
Fetch OnboardingsTool to retrieve onboardings.
Get Document ContentTool to retrieve base64-encoded document content.
Retrieve Onboarding StatusTool to retrieve the status of an onboarding.
Update ConfigurationTool to update an existing configuration.

Way Forward

With Identitycheck 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.

How to build Identitycheck MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Identitycheck MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Identitycheck MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Identitycheck MCP with Claude Code

Codex logo

Codex

Use Identitycheck MCP with Codex

OpenClaw logo

OpenClaw

Use Identitycheck MCP with OpenClaw

CLI logo

CLI

Use Identitycheck MCP with CLI

Google ADK logo

Google ADK

Use Identitycheck MCP with Google ADK

LangChain logo

LangChain

Use Identitycheck MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Identitycheck MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Identitycheck MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Identitycheck MCP with LlamaIndex

CrewAI logo

CrewAI

Use Identitycheck MCP with CrewAI

FAQ

What are the differences in Tool Router MCP and Identitycheck MCP?

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

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

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

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free