---
schema_version: "1"
id: 0a6e34469123cf2606d4b59612a56985195719526536d6d7041d1283bd7bce46
title: agent mcp create (Developer Preview)
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/agent/cli_reference_agent_mcp_create.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_create.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: fde572aef7cd78da00e965437c3466c7fc4787349cb69179f353e269b2473740
products:
- Salesforce CLI Command Reference
- salesforcedx
---
# agent mcp create (Developer Preview)
Create an MCP server in the API Catalog.
**note:** This command is available as a developer preview. The command isn't generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. All commands, parameters, and other features are subject to change or deprecation at any time, with or without notice. Don't implement functionality developed with these commands or tools.
## Description for agent mcp create
Registers an external Model Context Protocol (MCP) server with the API Catalog and discovers its assets (tools, prompts, and resources). Provide the server URL and, when the server requires it, OAuth authorization details. When the authorization type is OAUTH you must supply the identity provider, client ID, client secret, and scope.
## Flags
| Flag Name (Long) | Flag Name (Short) | Description |
|------------------|-------------------|-------------|
| ‑‑api‑version | N/A | **Type:** Value
Override the api version used for api requests made by this command |
| ‑‑auth‑type | N/A | **Type:** Value
**Valid Values:** `OAUTH`, `NO_AUTH`
**Default value:** `NO_AUTH`
Authorization type to use when connecting to the MCP server. |
| ‑‑client‑id | N/A | **Type:** Value
OAuth client ID. Required when auth-type is OAUTH. |
| ‑‑client‑secret | N/A | **Type:** Value
OAuth client secret. Required when auth-type is OAUTH. Pass "-" to read it from stdin (piped) and keep it out of shell history. |
| ‑‑description | N/A | **Type:** Value
Description of the MCP server. |
| ‑‑flags‑dir | N/A | **Type:** Value
Import flag values from a directory. |
| ‑‑identity‑provider | N/A | **Type:** Value
Identity provider to use for OAuth authorization. Required when auth-type is OAUTH. |
| ‑‑json | N/A | **Type:** Boolean
Format output as json. |
| ‑‑label | N/A | **Type:** Value
Human-readable label for the MCP server. |
| ‑‑name | ‑n | **Type:** Value
**Required**
Unique name of the MCP server. |
| ‑‑scope | N/A | **Type:** Value
OAuth scope to request. Required when auth-type is OAUTH. |
| ‑‑server‑url | N/A | **Type:** Value
**Required**
URL of the external MCP server. |
| ‑‑target‑org | ‑o | **Type:** Value
**Required**
Username or alias of the target org. Not required if the `target-org` configuration variable is already set. |
## Examples for agent mcp create
Create an MCP server with no authentication:
```shell
sf agent mcp create --name myServer --server-url https://mcp.example.com --target-org myOrg
```
Create an MCP server that uses OAuth authentication, piping the client secret from stdin to keep it out of shell history:
```shell
cat secret.txt | sf agent mcp create --name myServer --server-url https://mcp.example.com --auth-type OAUTH --identity-provider myIdp --client-id abc123 --client-secret - --scope "read write" --target-org myOrg
```