Skip to main content

Openlayer MCP

Model Context Protocol server for the Openlayer platform. It lets MCP clients — Cursor, VS Code, Claude Desktop, and other AI assistants — work with Openlayer in natural language.

With it, an assistant can:

  • Projects & versions — list and create projects; push and inspect commits.
  • Data sources — list, create, and inspect data sources (inference pipelines), and fetch their production traces, sessions, and per-user activity, with filters; comment on traces as the connected user.
  • Tests — list and create tests across integrity, consistency, and performance (including LLM-as-a-judge), trigger evaluation, read results, and drill into the rows that failed.
  • Anything else — call any Openlayer API endpoint directly, and search the Openlayer documentation.

Tools are annotated as read-only or destructive, so clients can auto-approve reads and confirm writes.

Tool names and schemas may evolve; clients should discover the available tools dynamically rather than hard-coding them.

📖 Full setup, the complete tool reference, and examples: openlayer.com/docs/openlayer-mcp

Installation

uv add openlayer-mcp     # or: pip install openlayer-mcp

Configuration

Register the server with your client and set your API key.

Claude Code (CLI):

claude mcp add openlayer --env OPENLAYER_API_KEY=YOUR_OPENLAYER_API_KEY -- uvx openlayer-mcp

Cursor, Claude Desktop, or VS Code (JSON config):

{
  "mcpServers": {
    "openlayer": {
      "command": "uvx",
      "args": ["openlayer-mcp"],
      "env": {
        "OPENLAYER_API_KEY": "YOUR_OPENLAYER_API_KEY"
      }
    }
  }
}
  • OPENLAYER_API_KEY (required) — create one in your Openlayer workspace settings.
  • OPENLAYER_BASE_URL (optional) — point at a self-hosted Openlayer instance; defaults to Openlayer Cloud.

Verify it's working by asking your assistant: "List my Openlayer projects."

You can also run it as a standalone server:

uv run -m openlayer_mcp

Transport

The server runs over stdio by default (for local IDE/desktop clients). For hosted or multi-client deployments, set OPENLAYER_MCP_TRANSPORT to streamable-http, http, or sse:

OPENLAYER_MCP_TRANSPORT=streamable-http uv run -m openlayer_mcp

Remote hosting

This repo also has a separate remote server package (server/, not published to PyPI) that runs the same tools as an OAuth-protected Streamable HTTP connector for Claude. Its AWS infrastructure and deploy live in the in-repo CDK app under awscdk/; its Docker image is published to the private Docker Hub repo openlayer/openlayer-mcp for self-hosting/on-prem customers we grant pull access to. See server/README.md.

Documentation

For the full guide and the complete list of available tools, see openlayer.com/docs/openlayer-mcp.

Metadata

Release files for openlayer-mcp 0.19.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openlayer-mcp 0.19.0
File Size Uploaded Provenance Actions
openlayer_mcp-0.19.0.tar.gz 57.7 kB Without provenance Details for openlayer_mcp-0.19.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openlayer-mcp 0.19.0
File Interpreter ABI Platform Actions
openlayer_mcp-0.19.0-py3-none-any.whl Python 3 none any Details for openlayer_mcp-0.19.0-py3-none-any.whl

Total release size: 129.4 kB

Release files / openlayer_mcp-0.19.0.tar.gz

Download URL openlayer_mcp-0.19.0.tar.gz
Size 57.7 kB
Tags Source
SHA-256 checksum
How to use checksums
417247c042d4f6152ea386d4279c469eafe20120e72c920def0b89429308dab7
BLAKE2b-256 checksum
How to use checksums
b946d86a90c5e3d806c7006e0e38a79e33150a0247979797903c69081721b51a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / openlayer_mcp-0.19.0-py3-none-any.whl

Download URL openlayer_mcp-0.19.0-py3-none-any.whl
Size 71.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
08d66a4b6ba32d77e184449403e9126a47f36c1eca291056b22eae246895602c
BLAKE2b-256 checksum
How to use checksums
aa7e26df349483589fd5d86f4592cc3de8b906a4fbad5ff92f2d579951456462
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for openlayer-mcp 0.19.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page