# diagrid mcpserver create

Create a MCP server

```
diagrid mcpserver create <mcpserver> [flags]
```

### Examples

```

  # Create using interactive prompt (recommended)
  diagrid mcpserver create --interactive

  # Create from a catalog template (fills URL, transport, headers, etc. from the template)
  diagrid mcpserver create my-gh --project my-project --from-catalog github --header Authorization:"Bearer ghp_xxx"

  # Create a streamable HTTP MCP server
  diagrid mcpserver create my-mcp --project my-project --url https://mcp.example.com/mcp

  # Create with headers and scopes
  diagrid mcpserver create my-mcp --project my-project --url https://mcp.example.com/mcp --header X-API-Key:secret --scope app1 --scope app2

  # Create with catalog metadata
  diagrid mcpserver create my-mcp --project my-project --url https://mcp.example.com/mcp --display-name "My MCP Server" --description "Custom operations and tools"

```

### Options

```
  -p, --project string                Name of existing project
      --interactive                   Create using an interactive prompt (recommended)
      --from-catalog string           Pre-fill from a catalog template; see 'diagrid mcpserver catalog list' for names
      --auth-profile string           Auth method to use from a multi-auth catalog template (e.g. bearer-header, oauth2-client-credentials, spiffe-jwt); accepted values come from the template's advertised set
      --url string                    URL for the MCP server endpoint
      --transport string              Transport type: streamable-http (default) or sse
      --timeout string                Per-call deadline (e.g. 30s, 1m)
      --scope stringArray             id scopes (repeatable)
      --header stringArray            Headers in Name:Value format (repeatable)
      --oauth2-issuer string          OAuth2 token endpoint URL
      --oauth2-audience string        OAuth2 audience
      --oauth2-scope stringArray      OAuth2 scope (repeatable)
      --oauth2-client-id string       OAuth2 client identifier sent to the token endpoint
      --oauth2-client-secret string   OAuth2 client secret (stored securely via transparent secret management)
      --spiffe-jwt-header string      SPIFFE JWT injection header name
      --spiffe-jwt-audience string    SPIFFE JWT audience. Optional for Catalyst-hosted MCPServers (defaults to the workload's SPIFFE ID). REQUIRED for external MCPServers whose verifier expects a different audience.
      --spiffe-jwt-prefix string      SPIFFE JWT header value prefix (e.g. "Bearer ")
      --protocol-version string       MCP protocol version (e.g. "2025-06-18")
      --display-name string           Catalog display name
      --description string            Catalog description
      --owner-team string             Team responsible for this MCP server
      --owner-contact string          Contact for the team
      --tags stringArray              Tag for discoverability (repeatable)
      --reference-links stringArray   Link as name:url (repeatable, e.g. docs:https://...)
  -w, --wait                          Wait for long-running resource creation to finish
  -h, --help                          help for create
```

### Options inherited from parent commands

```
      --api-key string   Diagrid Cloud API key
```

### SEE ALSO

- [diagrid mcpserver](./mcpserver.md)	 - Manage MCP servers