MCP Tools Reference: pubsub.googleapis.com

Tool: delete_topic

Delete an existing Cloud Pub/Sub topic.

Parameters

  • topic: The name of the topic to delete in the format projects/{project_id}/topics/{topic_name}.

Returns

  • google.protobuf.Empty if the topic exists.

  • A NOT_FOUND error if the topic does not exist.

Important Notes

  • A topic is a named resource that represents a feed of messages.

  • Existing subscriptions to this topic are not deleted, but their topic field is set to _deleted-topic_.

  • A project ID and topic name must be provided.

The following sample demonstrate how to use curl to invoke the delete_topic MCP tool.

Curl Request 
                  
curl --location 'https://pubsub.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "delete_topic",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

Request for the DeleteTopic method.

DeleteTopicRequest

JSON representation 
{
  "topic": string
}
Fields
topic

string

Required. Name of the topic to delete. Format is projects/{project}/topics/{topic}.

Output Schema

A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance:

service Foo {
  rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
}

Tool Annotations

Destructive Hint: ✅ | Idempotent Hint: ✅ | Read Only Hint: ❌ | Open World Hint: ✅