How to integrate Studio By Ai21 Labs MCP with Hermes

GET STARTED FOR FREE
Studio By Ai21 Labs 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 Studio By Ai21 Labs 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 Studio By Ai21 Labs 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 Studio By Ai21 Labs 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 Studio By Ai21 Labs

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

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

5. Done!

What is the Studio By Ai21 Labs MCP server, and what's possible with it?

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

Supported Tools & Triggers

Tools
Check Can IframeTool to check if a URL can be embedded in an iframe.
Compare TextTool to compare two text strings and identify differences.
Create Aftersales Parts Classification BatchTool to create a batch job for Fnac Aftersales parts classification.
Create Assistant RouteTool to create a new route for an AI21 Studio assistant.
Create AssistantTool to create a new AI assistant in AI21 Studio.
Create Assistant PlanTool to create a new plan for an AI21 Studio assistant.
Create DemoTool to create a new demo in AI21 Studio.
Generate RequirementsTool to generate requirements from a query or task description.
Generate Thread NameTool to generate a thread name from a query or conversation context.
Create Kirsh Grant Compliance PreviewTool to preview grant compliance for Kirsh grants.
Kirsh Grant Metadata PreviewTool to retrieve grant metadata from the Kirsh preview endpoint.
Create MCP StorageTool to create MCP (Model Context Protocol) storage in AI21 Studio.
Create SecretTool to save a secret in AI21 Studio.
Check Kirsh Grant ComplianceTool to check compliance for Kirsh grant IDs.
Create Website ConnectorTool to create a website connector in AI21 Studio.
Delete AssistantTool to delete an assistant by its unique ID.
Delete Assistant RouteTool to delete a route from an AI21 Studio assistant.
Delete DemoTool to delete a demo by its unique ID.
Delete MCP StorageTool to delete an MCP (Model Context Protocol) storage configuration by its unique ID.
Delete SecretTool to delete a secret by its unique ID.
Delete Website ConnectorPermanently delete a website connector by its unique identifier.
Download Modified DocumentTool to download a modified document from AI21 Labs Studio.
Get AssistantTool to retrieve an assistant by its unique identifier.
Get Assistant RouteTool to retrieve details of a specific route for an AI21 Studio assistant.
Get Assistants By MCPTool to retrieve all assistants associated with a specific MCP (Model Context Protocol) storage configuration.
Get Batch Prediction StatusTool to check the status of a Fnac Aftersales parts classification batch prediction job.
Get DemoTool to retrieve a demo by its unique ID.
Grant Kirsh MetadataTool to retrieve Kirsh grant metadata by grant ID.
Get Library Batch StatusTool to get the ingestion status of a library batch.
Get MCP StorageTool to retrieve a specific MCP (Model Context Protocol) storage configuration by its unique ID.
Get Output ExplanationTool to get output explanation for an execution (cached or generated).
Get PlanTool to retrieve a specific plan from an AI21 Studio assistant.
Get Website Connector By IDTool to retrieve details of a specific website connector by its ID.
Get Website Connector StatusTool to retrieve the status of a website connector ingestion.
Get Website Connector URL StatusTool to retrieve the status of a specific URL in the website connector.
Ingest Website ConnectorTool to ingest website content via sitemap URL in AI21 Studio.
Ingest Website Connector URLTool to ingest a website URL into AI21 Studio's website connector.
List AssistantsTool to retrieve all assistants from AI21 Studio.
List Website ConnectorsTool to retrieve website connector information from AI21 Studio.
List DemosTool to retrieve all demos from AI21 Studio.
List Library FilesTool to list files in the workspace library with optional filtering.
List MCP StorageTool to retrieve all MCP (Model Context Protocol) storage configurations from AI21 Studio.
List ModelsTool to retrieve information about all available AI21 models.
List PlansTool to list all plans for a specific assistant.
List SecretsTool to retrieve all secrets from AI21 Studio secret storage.
List Workspace ModelsTool to retrieve all workspace models by organization from AI21 Studio.
List Available ModelsTool to retrieve all available models from AI21 Studio settings.
Modify AssistantTool to modify an existing AI21 Studio assistant.
Modify Assistant RouteTool to modify an existing route within an assistant.
Modify Assistant PlanTool to modify an existing assistant plan in AI21 Studio.
Retry Ingest WebsiteTool to retry ingestion of a website in AI21 Studio.
Run AssistantTool to run an AI21 Studio assistant with conversational input.
Sync Website ConnectorTool to sync a website connector in AI21 Studio.
Update DemoTool to update an existing demo in Studio by AI21 Labs.
Update MCP StorageTool to update an existing MCP (Model Context Protocol) storage configuration in AI21 Studio.
Update SecretTool to update an existing secret in AI21 Studio.
Validate PlanTool to validate Python code for an AI21 Studio assistant plan.

Way Forward

With Studio By Ai21 Labs 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 Studio By Ai21 Labs MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Studio By Ai21 Labs MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Studio By Ai21 Labs MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Studio By Ai21 Labs MCP with Claude Code

Codex logo

Codex

Use Studio By Ai21 Labs MCP with Codex

OpenClaw logo

OpenClaw

Use Studio By Ai21 Labs MCP with OpenClaw

CLI logo

CLI

Use Studio By Ai21 Labs MCP with CLI

Google ADK logo

Google ADK

Use Studio By Ai21 Labs MCP with Google ADK

LangChain logo

LangChain

Use Studio By Ai21 Labs MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Studio By Ai21 Labs MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Studio By Ai21 Labs MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Studio By Ai21 Labs MCP with LlamaIndex

CrewAI logo

CrewAI

Use Studio By Ai21 Labs MCP with CrewAI

FAQ

What are the differences in Tool Router MCP and Studio By Ai21 Labs MCP?

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

Can I manage the permissions and scopes for Studio By Ai21 Labs while using Tool Router?

Yes, absolutely. You can configure which Studio By Ai21 Labs 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 Studio By Ai21 Labs 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