You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Deprecated for LangSmith Cloud—use the [LangSmith Remote MCP](/langsmith/langsmith-remote-mcp) instead.**
9
+
**Deprecated—use the [LangSmith Remote MCP](/langsmith/langsmith-remote-mcp) instead.**
10
10
11
-
LangSmith Cloud now hosts an OAuth-authenticated remote MCP server at the following regional endpoints:
11
+
LangSmith now hosts an OAuth-authenticated remote MCP server on LangSmith Cloud and on [self-hosted LangSmith](/langsmith/self-hosted) v0.15 or later. Cloud endpoints:
It exposes the same tool surface as the standalone server documented on this page, but authenticates via OAuth 2.1 with dynamic client registration—no API key, no separate deployment, no header configuration.
16
18
17
-
The Remote MCP is **SaaS-only** for now. The standalone server documented below remains the supported path for [self-hosted LangSmith](/langsmith/self-hosted)deployments and for users who prefer running the server themselves.
19
+
The standalone server documented below remains the supported path for self-hosted deployments on versions earlier than v0.15 and for users who prefer running the server themselves.
18
20
</Warning>
19
21
20
22
The LangSmith MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server that integrates with [LangSmith](https://smith.langchain.com). It lets MCP-compatible clients (for example, AI coding assistants) read [conversation history](/langsmith/observability-concepts#threads), [prompts](/langsmith/manage-prompts-programmatically), [runs and traces](/langsmith/observability-concepts#runs), [datasets](/langsmith/evaluation-concepts#datasets), [experiments](/langsmith/evaluation-concepts#experiment), and billing usage from your LangSmith workspace.
The LangSmith Remote MCP is a [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server hosted by LangSmith. It exposes the same tools as the [standalone LangSmith MCP Server](/langsmith/langsmith-mcp-server) (conversation history, prompts, runs and traces, datasets, experiments, billing) but with OAuth-based authentication, so MCP-compatible clients connect directly without an API key, a separate deployment, or any header configuration.
9
9
10
-
<Note>
11
-
**LangSmith Cloud (SaaS) only.** The Remote MCP is available on all LangSmith Cloud regions (`api.smith.langchain.com`, `eu.api.smith.langchain.com`, `apac.api.smith.langchain.com`, and `aws.api.smith.langchain.com`). [Self-hosted LangSmith](/langsmith/self-hosted) deployments should continue to use the [standalone LangSmith MCP Server](/langsmith/langsmith-mcp-server).
12
-
</Note>
10
+
The Remote MCP is available on all LangSmith Cloud regions and on [self-hosted LangSmith](/langsmith/self-hosted) deployments running v0.15 or later. Self-hosted deployments on earlier versions should continue to use the [standalone LangSmith MCP Server](/langsmith/langsmith-mcp-server).
13
11
14
12
## Endpoints
15
13
14
+
**LangSmith Cloud:**
15
+
16
16
<SaasRegionUrlsprefix="api.smith"suffix="/mcp" />
17
17
18
-
The server discovers the rest of its OAuth metadata via [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414) at `/.well-known/oauth-authorization-server` on the same host, so a compliant MCP client only needs the URL in the table.
18
+
The server discovers the rest of its OAuth metadata via [RFC 8414](https://datatracker.ietf.org/doc/html/rfc8414) at `/.well-known/oauth-authorization-server` on the same host, so a compliant MCP client only needs the URL above.
19
+
20
+
**Self-hosted LangSmith:**
21
+
22
+
`https://<your-langsmith-host>/api/mcp`, where `<your-langsmith-host>` is the hostname of your LangSmith instance.
23
+
19
24
20
25
## Authentication
21
26
@@ -98,4 +103,6 @@ If a client loses its session (for example, after revoking access in your LangSm
98
103
99
104
## Self-hosted LangSmith
100
105
101
-
The Remote MCP is a SaaS-only feature, hosted alongside LangSmith Cloud—it is not yet available for [self-hosted LangSmith](/langsmith/self-hosted) deployments. To connect MCP clients to a self-hosted instance, run the [standalone LangSmith MCP Server](/langsmith/langsmith-mcp-server) in your own environment and point its `LANGSMITH_ENDPOINT` at your self-hosted instance.
106
+
[Self-hosted LangSmith](/langsmith/self-hosted) deployments on v0.15 or later expose the Remote MCP at `https://<your-langsmith-host>/api/mcp`. Configuration, authentication, and tool surface are identical to LangSmith Cloud.
107
+
108
+
For deployments on earlier versions, run the [standalone LangSmith MCP Server](/langsmith/langsmith-mcp-server) in your own environment and point its `LANGSMITH_ENDPOINT` at your self-hosted instance.
Copy file name to clipboardExpand all lines: src/langsmith/self-hosted-changelog.mdx
+29-8Lines changed: 29 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,18 +11,39 @@ rss: true
11
11
12
12
[Self-hosted LangSmith](/langsmith/self-hosted) is an add-on to the Enterprise plan designed for our largest, most security-conscious customers. For more details, refer to [Pricing](https://www.langchain.com/pricing). [Contact our sales team](https://www.langchain.com/contact-sales) if you want to get a license key to trial LangSmith in your environment.
LangSmith Self-Hosted v0.15 brings **reusable evaluators and a library of 30+ evaluator templates** that centralize evaluation across your workspace, ships **per-example assertions** alongside reference outputs in annotation queues, and lets you download **Insights reports** as PDFs for offline analysis. Several breaking changes are worth reviewing before upgrade: the `agent-bootstrap` script is deprecated, the Agent Builder rename to [Fleet](/langsmith/fleet) may require workload-identity service-account updates, and the `projects:update-retention` permission splits into `projects:increase-trace-tier` and `projects:decrease-trace-tier`.
17
18
18
-
This release packages the same LangSmith application version as [langsmith-0.15.0-rc.16](#langsmith-0150-rc16). The Helm chart was updated with the following changes:
19
+
Follow the [upgrade instructions](/langsmith/self-host-upgrades) to get access to everything. To book time with LangChain support for your upgrade, contact `support@langchain.dev`.
20
+
21
+
### Breaking changes
22
+
23
+
- Deprecated the `agent-bootstrap` script. LangSmith agents are now standalone services that deploy with the Helm chart instead of through the LangSmith Deployment control plane. If you were using [Fleet](/langsmith/fleet) through this script previously, this may require a migration. Contact support to walk through migration.
24
+
- Renamed Agent Builder to [Fleet](/langsmith/fleet). If you use workload identity, you may need to update any service accounts.
25
+
-`POST /workspaces/current/members` now requires `role_id` for [RBAC](/langsmith/rbac)-enabled organizations. Requests without it return `400` instead of defaulting to `WORKSPACE_ADMIN`.
26
+
- Deprecated the `USAGE_EXPORT_ADMIN_EMAILS` environment variable. Use `INSTANCE_ADMIN_EMAILS` instead.
27
+
- Replaced the `projects:update-retention` permission with `projects:increase-trace-tier` and `projects:decrease-trace-tier` for separate control over raising and lowering trace retention. Permissions were backfilled to existing roles, so no changes are needed for existing roles. New roles should use the new permissions. See [RBAC permissions](/langsmith/rbac).
28
+
- Added a `fleet-admin:read` permission that gates the new Fleet Admin section. Admins of existing tenants need to grant it. Permissions were backfilled to existing roles, so no changes are needed for existing roles. New roles should use the new permissions. See [RBAC permissions](/langsmith/rbac).
29
+
30
+
### Infrastructure changes
31
+
32
+
-**Section renames from the Fleet rename** — several sections were renamed as part of the Agent Builder to [Fleet](/langsmith/fleet) rename (see [Breaking changes](#breaking-changes)). You may need to update service accounts or shift values in your configuration.
33
+
34
+
### New features
35
+
36
+
-**Reusable evaluators and evaluator templates** — a new [Evaluators](/langsmith/evaluators) tab centralizes every evaluator in your workspace, with 30+ templates covering safety, response quality, trajectory, user behavior, and multimodal evaluation. Attach an existing evaluator to a new tracing project in seconds without maintaining duplicate copies.
37
+
-**Per-example assertions** — write [assertions](/langsmith/assertions) instead of or alongside reference outputs when editing examples in an [annotation queue](/langsmith/annotation-queues).
38
+
-**Downloadable Insights reports** — download an [Insights](/langsmith/insights) report as a PDF from the report details page for offline analysis.
- Added `LOG_LEVEL` env var to the presidio analyzer deployment.
22
-
- Wired `LANGGRAPH_DEPLOYMENT_URL` into platform-backend deployments when Fleet is enabled.
42
+
-**Expanded ABAC coverage** — [ABAC](/langsmith/abac) now applies to `runs:create` on `POST /runs` and `POST /runs/batch`, plus the remaining `/sessions/{session_id}/` endpoints.
43
+
-**SCIM email-case-mismatch fix** — identity providers that send a different email casing are no longer rejected as email-change attempts.
23
44
24
-
**Download the Helm chart:**[`langsmith-0.15.0-rc.17.tgz`](https://github.com/langchain-ai/helm/releases/download/langsmith-0.15.0-rc.17/langsmith-0.15.0-rc.17.tgz)
0 commit comments