Which authentication methods does it support?

The README lists OAuth, API keys, service accounts, and other credential flows.

Can Metorial be self-hosted?

The Metorial Platform engine is open source and can be self-hosted.

Which client integrations are mentioned?

The README specifically mentions use with Cursor, Claude Code, and Codex; Cursor is an MCP client listed here.

Metorial

integrationsauthenticationaccess-controlobservabilitymcp

Centralizes authentication, permissions, observability, and access to 1200+ integrations for AI agents.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "metorial-metorial": {
      "command": "uvx",
      "args": [
        "metorial"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Metorial provides a control plane between AI agents and external systems, standardizing authentication, permissions, and auditability. It supports OAuth, API keys, service accounts, RBAC, scoped access, and audit logs. Use it when multiple agents or teams need governed access to SaaS tools, enterprise systems, data sources, or MCP servers.

Use cases

Connect agents to SaaS and enterprise systems

Manage OAuth and API credential lifecycles

Enforce scoped permissions across agents and environments

Audit which agents acted with specific credentials

Reuse integrations across projects and teams

Key features

1200+ integrations

OAuth, API key, and service account management

RBAC, SAML SSO, and IAM

Scoped permissions by agent, workflow, team, or environment

Audit logs and action traceability

JavaScript/TypeScript and Python SDKs

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Metorial.

Extracted Tool Capabilities

1200+ integrations

OAuth, API key, and service account management

RBAC, SAML SSO, and IAM

Scoped permissions by agent, workflow, team, or environment

Audit logs and action traceability

JavaScript/TypeScript and Python SDKs

Documentation Overview

Metorial (YC F25)

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.

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

server.ts

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';
import { anthropic } from '@ai-sdk/anthropic';
import { stepCountIs, streamText } from 'ai';

let metorial = new Metorial({ apiKey: process.env.METORIAL_API_KEY! });

let deployment = await metorial.providerDeployments.create({
  name: 'Metorial Search',
  providerId: 'metorial-search'
});

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [{ providerDeploymentId: deployment.id }]
});

let result = streamText({
  model: anthropic('claude-sonnet-4-20250514'),
  prompt:
    'Search the web for the latest news about AI agents and summarize the top 3 stories.',
  stopWhen: stepCountIs(10),
  tools: session.tools()
});

for await (let part of result.textStream) {
  process.stdout.write(part);
}

Install it with:

Terminal

npm install metorial @metorial/ai-sdk @ai-sdk/anthropic ai

Python

server.ts

import asyncio
import os

from metorial import Metorial
from metorial import metorial_pydantic_ai
from pydantic_ai import Agent

async def main():
  metorial = Metorial(api_key=os.environ["METORIAL_API_KEY"])

  deployment = metorial.provider_deployments.create(
    name="Metorial Search",
    provider_id="metorial-search",
  )

  session = await metorial.connect(
    adapter=metorial_pydantic_ai(),
    providers=[{"provider_deployment_id": deployment.id}],
  )

  agent = Agent(
    "anthropic:claude-sonnet-4-20250514",
    system_prompt="You are a helpful research assistant.",
    tools=session.tools(),
  )

  result = await agent.run(
    "Search the web for the latest news about AI agents and summarize the top 3 stories."
  )
  print(result.output)

asyncio.run(main())

Install it with:

Terminal

pip install metorial pydantic-ai python-dotenv

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.

JavaScript / TypeScript

server.ts

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';

let metorial = new Metorial({ apiKey: process.env.METORIAL_API_KEY! });

let setupSession = await metorial.providerDeployments.setupSessions.create({
  providerId: 'your-slack-provider-id',
  providerAuthMethodId: 'your-slack-auth-method-id'
});

console.log(`Authenticate here: ${setupSession.url}`);

let completed = await metorial.providerDeployments.setupSessions.waitForCompletion([
  setupSession
]);

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [
    {
      providerDeploymentId: 'your-slack-deployment-id',
      providerAuthConfigId: completed[0]!.authConfig!.id
    }
  ]
});

// Pass session.tools() to your model SDK.

Python

server.ts

import os

from metorial import Metorial
from metorial import metorial_pydantic_ai

metorial = Metorial(api_key=os.environ["METORIAL_API_KEY"])

setup_session = metorial.provider_deployments.setup_sessions.create(
  provider_id="your-slack-provider-id",
  provider_auth_method_id="oauth",
  redirect_url="https://yourapp.com/oauth/callback",
)

print(f"Authenticate here: {setup_session.url}")

completed = await metorial.wait_for_setup_session([setup_session])

session = await metorial.connect(
  adapter=metorial_pydantic_ai(),
  providers=[
    {
      "provider_deployment_id": "your-slack-deployment-id",
      "provider_auth_config_id": completed[0].auth_config.id,
    }
  ],
)
tools = session.tools()

OAuth Flow Explained

Create a setup session: Call providerDeployments.setupSessions.create() in TypeScript or provider_deployments.setup_sessions.create() in Python.
Send the URL: Show the setup session URL to users so they can authenticate in their browser.
Wait for completion: Wait for the setup session to finish and return an auth config.
Use the auth config: Pass the auth config ID when configuring providers.

Provider Configuration Examples

Use the same providers list to combine dashboard-managed deployments, pre-created auth configs, inline credentials, and reusable session templates:

typescript

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [
    { providerDeploymentId: 'your-search-deployment-id' },
    {
      providerDeploymentId: 'your-slack-deployment-id',
      providerAuthConfigId: 'slack-auth-config-id'
    },
    {
      providerDeploymentId: 'your-github-deployment-id',
      providerAuthConfig: {
        providerAuthMethodId: 'github-auth-method-id',
        credentials: { access_token: 'ghp_...' }
      }
    },
    { sessionTemplateId: 'your-template-id' }
  ]
});

python

session = await metorial.connect(
  adapter=metorial_pydantic_ai(),
  providers=[
    {"provider_deployment_id": "your-search-deployment-id"},
    {
      "provider_deployment_id": "your-slack-deployment-id",
      "provider_auth_config_id": "slack-auth-config-id",
    },
    {
      "provider_deployment_id": "your-github-deployment-id",
      "provider_auth_config": {
        "provider_auth_method_id": "github-auth-method-id",
        "credentials": {"access_token": "ghp_..."},
      },
    },
    {"session_template_id": "your-template-id"},
  ],
)

Examples

Check out the SDK example directories for complete working examples:

TypeScript

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

3.4k

Stargazers on the source repository.

npm downloads

889

Package downloads in the last 30 days.

Last commit

2d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Metorial

It provides a shared access layer between AI agents and external systems, handling authentication, permissions, and observability.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/metorial-metorial?style=directory)](https://allmcps.com/mcp/metorial-metorial)

HTML Embed

<a href="https://allmcps.com/mcp/metorial-metorial"><img src="https://allmcps.com/api/badge/metorial-metorial?style=directory" alt="Metorial on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

11/11 checks healthy over the last 32d

55Quality signal: Good · 55/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools18/30

Adoption & activity13/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · metorial (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to Metorial →Install in Claude Desktop Install in Cursor Install in VS Code

Metorial

integrationsauthenticationaccess-controlobservabilitymcp

Centralizes authentication, permissions, observability, and access to 1200+ integrations for AI agents.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "metorial-metorial": {
      "command": "uvx",
      "args": [
        "metorial"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Connect agents to SaaS and enterprise systems

Manage OAuth and API credential lifecycles

Enforce scoped permissions across agents and environments

Audit which agents acted with specific credentials

Reuse integrations across projects and teams

Key features

1200+ integrations

OAuth, API key, and service account management

RBAC, SAML SSO, and IAM

Scoped permissions by agent, workflow, team, or environment

Audit logs and action traceability

JavaScript/TypeScript and Python SDKs

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Metorial.

Extracted Tool Capabilities

1200+ integrations

OAuth, API key, and service account management

RBAC, SAML SSO, and IAM

Scoped permissions by agent, workflow, team, or environment

Audit logs and action traceability

JavaScript/TypeScript and Python SDKs

Documentation Overview

Metorial (YC F25)

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

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.

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

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

server.ts

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';
import { anthropic } from '@ai-sdk/anthropic';
import { stepCountIs, streamText } from 'ai';

let metorial = new Metorial({ apiKey: process.env.METORIAL_API_KEY! });

let deployment = await metorial.providerDeployments.create({
  name: 'Metorial Search',
  providerId: 'metorial-search'
});

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [{ providerDeploymentId: deployment.id }]
});

let result = streamText({
  model: anthropic('claude-sonnet-4-20250514'),
  prompt:
    'Search the web for the latest news about AI agents and summarize the top 3 stories.',
  stopWhen: stepCountIs(10),
  tools: session.tools()
});

for await (let part of result.textStream) {
  process.stdout.write(part);
}

Install it with:

Terminal

npm install metorial @metorial/ai-sdk @ai-sdk/anthropic ai

Python

server.ts

import asyncio
import os

from metorial import Metorial
from metorial import metorial_pydantic_ai
from pydantic_ai import Agent

async def main():
  metorial = Metorial(api_key=os.environ["METORIAL_API_KEY"])

  deployment = metorial.provider_deployments.create(
    name="Metorial Search",
    provider_id="metorial-search",
  )

  session = await metorial.connect(
    adapter=metorial_pydantic_ai(),
    providers=[{"provider_deployment_id": deployment.id}],
  )

  agent = Agent(
    "anthropic:claude-sonnet-4-20250514",
    system_prompt="You are a helpful research assistant.",
    tools=session.tools(),
  )

  result = await agent.run(
    "Search the web for the latest news about AI agents and summarize the top 3 stories."
  )
  print(result.output)

asyncio.run(main())

Install it with:

Terminal

pip install metorial pydantic-ai python-dotenv

OAuth Integration

JavaScript / TypeScript

server.ts

import { Metorial } from 'metorial';
import { metorialAiSdk } from '@metorial/ai-sdk';

let metorial = new Metorial({ apiKey: process.env.METORIAL_API_KEY! });

let setupSession = await metorial.providerDeployments.setupSessions.create({
  providerId: 'your-slack-provider-id',
  providerAuthMethodId: 'your-slack-auth-method-id'
});

console.log(`Authenticate here: ${setupSession.url}`);

let completed = await metorial.providerDeployments.setupSessions.waitForCompletion([
  setupSession
]);

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [
    {
      providerDeploymentId: 'your-slack-deployment-id',
      providerAuthConfigId: completed[0]!.authConfig!.id
    }
  ]
});

// Pass session.tools() to your model SDK.

Python

server.ts

import os

from metorial import Metorial
from metorial import metorial_pydantic_ai

metorial = Metorial(api_key=os.environ["METORIAL_API_KEY"])

setup_session = metorial.provider_deployments.setup_sessions.create(
  provider_id="your-slack-provider-id",
  provider_auth_method_id="oauth",
  redirect_url="https://yourapp.com/oauth/callback",
)

print(f"Authenticate here: {setup_session.url}")

completed = await metorial.wait_for_setup_session([setup_session])

session = await metorial.connect(
  adapter=metorial_pydantic_ai(),
  providers=[
    {
      "provider_deployment_id": "your-slack-deployment-id",
      "provider_auth_config_id": completed[0].auth_config.id,
    }
  ],
)
tools = session.tools()

OAuth Flow Explained

Create a setup session: Call providerDeployments.setupSessions.create() in TypeScript or provider_deployments.setup_sessions.create() in Python.
Send the URL: Show the setup session URL to users so they can authenticate in their browser.
Wait for completion: Wait for the setup session to finish and return an auth config.
Use the auth config: Pass the auth config ID when configuring providers.

Provider Configuration Examples

Use the same providers list to combine dashboard-managed deployments, pre-created auth configs, inline credentials, and reusable session templates:

typescript

let session = await metorial.connect({
  adapter: metorialAiSdk(),
  providers: [
    { providerDeploymentId: 'your-search-deployment-id' },
    {
      providerDeploymentId: 'your-slack-deployment-id',
      providerAuthConfigId: 'slack-auth-config-id'
    },
    {
      providerDeploymentId: 'your-github-deployment-id',
      providerAuthConfig: {
        providerAuthMethodId: 'github-auth-method-id',
        credentials: { access_token: 'ghp_...' }
      }
    },
    { sessionTemplateId: 'your-template-id' }
  ]
});

python

session = await metorial.connect(
  adapter=metorial_pydantic_ai(),
  providers=[
    {"provider_deployment_id": "your-search-deployment-id"},
    {
      "provider_deployment_id": "your-slack-deployment-id",
      "provider_auth_config_id": "slack-auth-config-id",
    },
    {
      "provider_deployment_id": "your-github-deployment-id",
      "provider_auth_config": {
        "provider_auth_method_id": "github-auth-method-id",
        "credentials": {"access_token": "ghp_..."},
      },
    },
    {"session_template_id": "your-template-id"},
  ],
)

Examples

Check out the SDK example directories for complete working examples:

TypeScript

Read the full README →View source on GitHub →

Related MCP Servers

View all in Other Tools and Integrations View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

3.4k

Stargazers on the source repository.

npm downloads

889

Package downloads in the last 30 days.

Last commit

2d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Metorial

It provides a shared access layer between AI agents and external systems, handling authentication, permissions, and observability.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/metorial-metorial?style=directory)](https://allmcps.com/mcp/metorial-metorial)

HTML Embed

<a href="https://allmcps.com/mcp/metorial-metorial"><img src="https://allmcps.com/api/badge/metorial-metorial?style=directory" alt="Metorial on AllMCPs" /></a>

Technical Specs & Signals

CategoryOther Tools and Integrations

PricingFree

11/11 checks healthy over the last 32d

55Quality signal: Good · 55/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools18/30

Adoption & activity13/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 27d ago via OSV.dev · metorial (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🛠️ Other Tools and Integrations →Alternatives to Metorial →Install in Claude Desktop Install in Cursor Install in VS Code