1. Packages
  2. Packages
  3. Google Cloud (GCP) Classic
  4. API Docs
  5. agentregistry
  6. getMcpServer
Viewing docs for Google Cloud v9.32.1
published on Wednesday, Jul 29, 2026 by Pulumi
gcp logo
Viewing docs for Google Cloud v9.32.1
published on Wednesday, Jul 29, 2026 by Pulumi

    Get information about an Agent Registry MCP Server.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcp from "@pulumi/gcp";
    
    const _default = gcp.agentregistry.getMcpServer({
        location: "us-central1",
        mcpServerId: "apphub-00000000-0000-0000-0000-000000000000",
    });
    
    import pulumi
    import pulumi_gcp as gcp
    
    default = gcp.agentregistry.get_mcp_server(location="us-central1",
        mcp_server_id="apphub-00000000-0000-0000-0000-000000000000")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/agentregistry"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := agentregistry.GetMcpServer(ctx, &agentregistry.GetMcpServerArgs{
    			Location:    "us-central1",
    			McpServerId: pulumi.StringRef("apphub-00000000-0000-0000-0000-000000000000"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcp = Pulumi.Gcp;
    
    return await Deployment.RunAsync(() => 
    {
        var @default = Gcp.AgentRegistry.GetMcpServer.Invoke(new()
        {
            Location = "us-central1",
            McpServerId = "apphub-00000000-0000-0000-0000-000000000000",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcp.agentregistry.AgentregistryFunctions;
    import com.pulumi.gcp.agentregistry.inputs.GetMcpServerArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var default = AgentregistryFunctions.getMcpServer(GetMcpServerArgs.builder()
                .location("us-central1")
                .mcpServerId("apphub-00000000-0000-0000-0000-000000000000")
                .build());
    
        }
    }
    
    variables:
      default:
        fn::invoke:
          function: gcp:agentregistry:getMcpServer
          arguments:
            location: us-central1
            mcpServerId: apphub-00000000-0000-0000-0000-000000000000
    
    pulumi {
      required_providers {
        gcp = {
          source = "pulumi/gcp"
        }
      }
    }
    
    data "gcp_agentregistry_getmcpserver" "default" {
      location      = "us-central1"
      mcp_server_id = "apphub-00000000-0000-0000-0000-000000000000"
    }
    

    Using getMcpServer

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getMcpServer(args: GetMcpServerArgs, opts?: InvokeOptions): Promise<GetMcpServerResult>
    function getMcpServerOutput(args: GetMcpServerOutputArgs, opts?: InvokeOptions): Output<GetMcpServerResult>
    def get_mcp_server(filter: Optional[str] = None,
                       location: Optional[str] = None,
                       mcp_server_id: Optional[str] = None,
                       project: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetMcpServerResult
    def get_mcp_server_output(filter: pulumi.Input[Optional[str]] = None,
                       location: pulumi.Input[Optional[str]] = None,
                       mcp_server_id: pulumi.Input[Optional[str]] = None,
                       project: pulumi.Input[Optional[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetMcpServerResult]
    func GetMcpServer(ctx *Context, args *GetMcpServerArgs, opts ...InvokeOption) (*GetMcpServerResult, error)
    func GetMcpServerOutput(ctx *Context, args *GetMcpServerOutputArgs, opts ...InvokeOption) GetMcpServerResultOutput

    > Note: This function is named GetMcpServer in the Go SDK.

    public static class GetMcpServer 
    {
        public static Task<GetMcpServerResult> InvokeAsync(GetMcpServerArgs args, InvokeOptions? opts = null)
        public static Output<GetMcpServerResult> Invoke(GetMcpServerInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetMcpServerResult> getMcpServer(GetMcpServerArgs args, InvokeOptions options)
    public static Output<GetMcpServerResult> getMcpServer(GetMcpServerArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcp:agentregistry/getMcpServer:getMcpServer
      arguments:
        # arguments dictionary
    data "gcp_agentregistry_get_mcp_server" "name" {
        # arguments
    }

    The following arguments are supported:

    Location string
    The location of the resource.


    Filter string
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    McpServerId string
    The unique identifier for the MCP Server. This or filter must be set.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    Location string
    The location of the resource.


    Filter string
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    McpServerId string
    The unique identifier for the MCP Server. This or filter must be set.
    Project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    location string
    The location of the resource.


    filter string
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    mcp_server_id string
    The unique identifier for the MCP Server. This or filter must be set.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    location String
    The location of the resource.


    filter String
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    mcpServerId String
    The unique identifier for the MCP Server. This or filter must be set.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.
    location string
    The location of the resource.


    filter string
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    mcpServerId string
    The unique identifier for the MCP Server. This or filter must be set.
    project string
    The project in which the resource belongs. If it is not provided, the provider project is used.
    location str
    The location of the resource.


    filter str
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    mcp_server_id str
    The unique identifier for the MCP Server. This or filter must be set.
    project str
    The project in which the resource belongs. If it is not provided, the provider project is used.
    location String
    The location of the resource.


    filter String
    A filter string that identifies a unique MCP server. This or mcpServerId must be set.
    mcpServerId String
    The unique identifier for the MCP Server. This or filter must be set.
    project String
    The project in which the resource belongs. If it is not provided, the provider project is used.

    getMcpServer Result

    The following output properties are available:

    Attributes Dictionary<string, string>
    Attributes of the Agent.
    CreateTime string
    Create time.
    Description string
    The description of the MCP Server.
    DisplayName string
    The display name of the MCP Server.
    Id string
    The provider-assigned unique ID for this managed resource.
    Interfaces List<GetMcpServerInterface>
    The connection details for the MCP Server.
    Location string
    McpServerId string
    Project string
    Tools List<GetMcpServerTool>
    A list of tools available with the MCP Server.
    UpdateTime string
    Update time.
    Urn string
    The URN of the MCP Server.
    Filter string
    Attributes map[string]string
    Attributes of the Agent.
    CreateTime string
    Create time.
    Description string
    The description of the MCP Server.
    DisplayName string
    The display name of the MCP Server.
    Id string
    The provider-assigned unique ID for this managed resource.
    Interfaces []GetMcpServerInterface
    The connection details for the MCP Server.
    Location string
    McpServerId string
    Project string
    Tools []GetMcpServerTool
    A list of tools available with the MCP Server.
    UpdateTime string
    Update time.
    Urn string
    The URN of the MCP Server.
    Filter string
    attributes map(string)
    Attributes of the Agent.
    create_time string
    Create time.
    description string
    The description of the MCP Server.
    display_name string
    The display name of the MCP Server.
    id string
    The provider-assigned unique ID for this managed resource.
    interfaces list(object)
    The connection details for the MCP Server.
    location string
    mcp_server_id string
    project string
    tools list(object)
    A list of tools available with the MCP Server.
    update_time string
    Update time.
    urn string
    The URN of the MCP Server.
    filter string
    attributes Map<String,String>
    Attributes of the Agent.
    createTime String
    Create time.
    description String
    The description of the MCP Server.
    displayName String
    The display name of the MCP Server.
    id String
    The provider-assigned unique ID for this managed resource.
    interfaces List<GetMcpServerInterface>
    The connection details for the MCP Server.
    location String
    mcpServerId String
    project String
    tools List<GetMcpServerTool>
    A list of tools available with the MCP Server.
    updateTime String
    Update time.
    urn String
    The URN of the MCP Server.
    filter String
    attributes {[key: string]: string}
    Attributes of the Agent.
    createTime string
    Create time.
    description string
    The description of the MCP Server.
    displayName string
    The display name of the MCP Server.
    id string
    The provider-assigned unique ID for this managed resource.
    interfaces GetMcpServerInterface[]
    The connection details for the MCP Server.
    location string
    mcpServerId string
    project string
    tools GetMcpServerTool[]
    A list of tools available with the MCP Server.
    updateTime string
    Update time.
    urn string
    The URN of the MCP Server.
    filter string
    attributes Mapping[str, str]
    Attributes of the Agent.
    create_time str
    Create time.
    description str
    The description of the MCP Server.
    display_name str
    The display name of the MCP Server.
    id str
    The provider-assigned unique ID for this managed resource.
    interfaces Sequence[GetMcpServerInterface]
    The connection details for the MCP Server.
    location str
    mcp_server_id str
    project str
    tools Sequence[GetMcpServerTool]
    A list of tools available with the MCP Server.
    update_time str
    Update time.
    urn str
    The URN of the MCP Server.
    filter str
    attributes Map<String>
    Attributes of the Agent.
    createTime String
    Create time.
    description String
    The description of the MCP Server.
    displayName String
    The display name of the MCP Server.
    id String
    The provider-assigned unique ID for this managed resource.
    interfaces List<Property Map>
    The connection details for the MCP Server.
    location String
    mcpServerId String
    project String
    tools List<Property Map>
    A list of tools available with the MCP Server.
    updateTime String
    Update time.
    urn String
    The URN of the MCP Server.
    filter String

    Supporting Types

    GetMcpServerInterface

    ProtocolBinding string
    The protocol binding of the interface.
    Url string
    The destination URL.
    ProtocolBinding string
    The protocol binding of the interface.
    Url string
    The destination URL.
    protocol_binding string
    The protocol binding of the interface.
    url string
    The destination URL.
    protocolBinding String
    The protocol binding of the interface.
    url String
    The destination URL.
    protocolBinding string
    The protocol binding of the interface.
    url string
    The destination URL.
    protocol_binding str
    The protocol binding of the interface.
    url str
    The destination URL.
    protocolBinding String
    The protocol binding of the interface.
    url String
    The destination URL.

    GetMcpServerTool

    Annotations List<GetMcpServerToolAnnotation>
    Additional tool information.
    Description string
    The description of the tool.
    Name string
    The name of the tool.
    Annotations []GetMcpServerToolAnnotation
    Additional tool information.
    Description string
    The description of the tool.
    Name string
    The name of the tool.
    annotations list(object)
    Additional tool information.
    description string
    The description of the tool.
    name string
    The name of the tool.
    annotations List<GetMcpServerToolAnnotation>
    Additional tool information.
    description String
    The description of the tool.
    name String
    The name of the tool.
    annotations GetMcpServerToolAnnotation[]
    Additional tool information.
    description string
    The description of the tool.
    name string
    The name of the tool.
    annotations Sequence[GetMcpServerToolAnnotation]
    Additional tool information.
    description str
    The description of the tool.
    name str
    The name of the tool.
    annotations List<Property Map>
    Additional tool information.
    description String
    The description of the tool.
    name String
    The name of the tool.

    GetMcpServerToolAnnotation

    DestructiveHint bool
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    IdempotentHint bool
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    OpenWorldHint bool
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    ReadOnlyHint bool
    If true, the tool does not modify its environment.
    Title string
    A human-readable title for the tool.
    DestructiveHint bool
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    IdempotentHint bool
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    OpenWorldHint bool
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    ReadOnlyHint bool
    If true, the tool does not modify its environment.
    Title string
    A human-readable title for the tool.
    destructive_hint bool
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    idempotent_hint bool
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    open_world_hint bool
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    read_only_hint bool
    If true, the tool does not modify its environment.
    title string
    A human-readable title for the tool.
    destructiveHint Boolean
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    idempotentHint Boolean
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    openWorldHint Boolean
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    readOnlyHint Boolean
    If true, the tool does not modify its environment.
    title String
    A human-readable title for the tool.
    destructiveHint boolean
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    idempotentHint boolean
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    openWorldHint boolean
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    readOnlyHint boolean
    If true, the tool does not modify its environment.
    title string
    A human-readable title for the tool.
    destructive_hint bool
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    idempotent_hint bool
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    open_world_hint bool
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    read_only_hint bool
    If true, the tool does not modify its environment.
    title str
    A human-readable title for the tool.
    destructiveHint Boolean
    If true, the tool may perform destructive updates to its environment. If false, the tool performs only additive updates.
    idempotentHint Boolean
    If true, calling the tool repeatedly with the same arguments will have no additional effect on the its environment.
    openWorldHint Boolean
    If true, this tool may interact with an “open world” of external entities. If false, the tool’s domain of interaction is closed. For example, the world of a web search tool is open, whereas that of a memory tool is not
    readOnlyHint Boolean
    If true, the tool does not modify its environment.
    title String
    A human-readable title for the tool.

    Package Details

    Repository
    Google Cloud (GCP) Classic pulumi/pulumi-gcp
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the google-beta Terraform Provider.
    gcp logo
    Viewing docs for Google Cloud v9.32.1
    published on Wednesday, Jul 29, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial