metorial/metorial

Open-source identity and access layer for AI agents.
Connect agents to real systems with consistent auth, permissions, and observability.
> [!TIP]
> _Skip the setup and go hosted:_ The fastest, simplest and most reliable way to use Metorial is to sign up to our hosted platform.
>
> ➡️ **Get Started (for free)**
Introduction
Agents are being connected to production systems, but without a consistent identity and access layer around them: limited access control, no auditing, and no standard access restrictions. Metorial solves that.
Metorial is a control plane for agent access to external systems. It sits between agents and integrations, handling auth, permissions, and observability in a consistent way. Instead of wiring integrations ad hoc, teams get a shared layer that standardizes how agents interact with systems.
Core Capabilities
- **1200+ integrations** across SaaS tools, enterprise systems, data sources, and custom MCP servers.
- **Auth and token lifecycle management** for OAuth, API keys, service accounts, and other credential flows.
- **RBAC, SAML SSO, and IAM built in** so agent access follows your existing security model.
- **Scoped permissions** per agent, workflow, team, or environment.
- **Audit logs and traceability** for agent actions, including which agent acted with whose credentials.
- **Shared access patterns** across teams and projects instead of one-off integration code.
Metorial for Developers
Metorial gives developers a single interface for connecting agents to real systems.
- Use integrations across tools like Claude Code, Codex, and Cursor without breaking security policies.
- Expose integrations as tools to any agent framework.
- Unify OAuth, API keys, and other auth flows into one magic URL.
- Reuse connections across projects, environments, and people.
- Avoid re-implementing integration and auth logic for every app.
You write against one API, or use one connection URL, and Metorial handles the rest.
Metorial for Security
Metorial provides structure and visibility into how agents access systems.
- Centralized access control with RBAC, SAML SSO, IAM, and scoped credentials.
- Clear permission boundaries per agent.
- Audit logs for all actions, including which agent performed them using whose credentials.
- Controlled sharing of integrations.
- Consistent and secure credential handling.
This makes agent activity enforceable and inspectable without relying on manual processes. Makes your Head of AI happy, lets your CISO sleep at night.
Ecosystem
- **Metorial**: Integration catalog covering SaaS tools and enterprise systems.
- **Metorial Platform**: Core engine, open source and self-hostable.
- **Metorial CLI**: Agent-first CLI for interacting with integrations.
- **Lowerdeck**: Shared libraries across the stack.
- **Starbase**: MCP debugging and testing utility.
SDKs
The SDKs expose the Metorial API and integrate with agent frameworks.
They handle auth, access control, and tool exposure in a consistent way.
- **JavaScript / TypeScript**
- **Python**
If you want to build a custom integration, check out our API documentation for details on how to use the Metorial API directly.
Self-Hosting
The Metorial Platform is the code that powers the engine behind Metorial. It is open source and can be self-hosted. You can use it to run your own Metorial instance, powered by the MCP servers in this repo.
Quick Start
The simplest way to get started is with **Metorial Search**, a built-in web search provider that requires no auth configuration.
JavaScript / TypeScript
Install it with:
Python
Install it with:
OAuth Integration
When working with services that require user authentication, such as Slack, GitHub, Google Calendar, or SAP, Metorial provides setup sessions to handle the OAuth flow and then reuse the resulting auth config.