com.googleapis.firestore/mcp
v1.0.0Interact with your Google Cloud Firestore resources using natural language commands.
Endpoint health
online- Last checked
- 11/20/2026, 6:17:59 AM
- Latency
- 105 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.googleapis.firestore%2Fmcp
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.googleapis.firestore/mcp": {
"url": "https://firestore.googleapis.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
23 shown · authentication unknown
add_document
Create a document from a Firestore database.
Schema valid · SHA-256 1d00a300cad9…
View input schema
{ "type": "object", "properties": { "collectionId": { "description": "Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.", "type": "string" }, "document": { "$ref": "#/$defs/Document", "description": "Required. The document to create. `name` must not be set." }, "documentId": { "description": "The client-assigned document ID to use for this document. Optional. If not specified, an ID will be assigned by the service.", "type": "string" }, "mask": { "$ref": "#/$defs/DocumentMask", "description": "The fields to return. If not set, returns all fields. If the document has a field that is not present in this mask, that field will not be returned in the response." }, "parent": { "description": "Required. The parent resource. For example: `projects/{project_id}/databases/{database_id}/documents` or `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`", "type": "string" }, "requestOptions": { "$ref": "#/$defs/RequestOptions", "description": "Optional. The request options for this request." } }, "required": [ "parent", "collectionId", "document" ], "$defs": { "ArrayValue": { "description": "An array value.", "properties": { "values": { "description": "Values in the array.", "items": { "$ref": "#/$defs/Value" }, "type": "array" } }, "type": "object" }, "Document": { "description": "A Firestore document. Must not exceed 1 MiB - 4 bytes.", "properties": { "createTime": { "description": "Output only. The time at which the document was created. This value increases monotonically when a document is deleted then recreated. It can also be compared to values from other documents and the `read_time` of a query.", "format": "date-time", "type": "string" }, "fields": { "additionalProperties": { "$ref": "#/$defs/Value" }, "description": "The document's fields. The map keys represent field names. Field names matching the regular expression `__.*__` are reserved. Reserved field names are forbidden except in certain documented contexts. The field names, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty. Field paths may be used in other contexts to refer to structured fields defined here. For `map_value`, the field path is represented by a dot-delimited (`.`) string of segments. Each segment is either a simple field name (defined below) or a quoted field name. For example, the structured field `\"foo\" : { map_value: { \"x&y\" : { string_value: \"hello\" }}}` would be represented by the field path `` foo.`x&y` ``. A simple field name contains only characters `a` to `z`, `A` to `Z`, `0` to `9`, or `_`, and must not start with `0` to `9`. For example, `foo_bar_17`. A quoted field name starts and ends with `` ` `` and may contain any character. Some characters, including `` ` ``, must be escaped using a `\\`. For example, `` `x&y` `` represents `x&y` and `` `bak\\`tik` `` represents `` bak`tik ``.", "type": "object" }, "name": { "description": "The resource name of the document, for example `projects/{project_id}/databases/{database_id}/documents/{document_path}`.", "type": "string" }, "updateTime": { "description": "Output only. The time at which the document was last changed. This value is initially set to the `create_time` then increases monotonically with each change to the document. It can also be compared to values from other documents and the `read_time` of a query.", "format": "date-time", "type": "string" } }, "type": "object" }, "DocumentMask": { "description": "A set of field paths on a document. Used to restrict a get or update operation on a document to a subset of its fields. This is different from standard field masks, as this is always scoped to a Document, and takes in account the dynamic nature of Value.", "properties": { "fieldPaths": { "description": "The list of field paths in the mask. See Document.fields for a field path syntax reference.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "Function": { "description": "Represents an unevaluated scalar expression. For example, the expression `like(user_name, \"%alice%\")` is represented as: ``` name: \"like\" args { field_reference: \"user_name\" } args { string_value: \"%alice%\" } ```", "properties": { "args": { "description": "Optional. Ordered list of arguments the given function expects.", "items": { "$ref": "#/$defs/Value" }, "type": "array" }, "name": { "description": "Required. The name of the function to evaluate. **Requires:** * must be in snake case (lower case with underscore separator).", "type": "string" }, "options": { "additionalProperties": { "$ref": "#/$defs/Value" }, "description": "Optional. Optional named arguments that certain functions may support.", "type": "object" } }, "required": [ "name" ], "type": "object" }, "LatLng": { "description": "An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard <https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version>. Values must be within normalized ranges.", "properties": { "latitude": { "description": "The latitude in degrees. It must be in the range [-90.0, +90.0].", "format": "double", "type": "number" }, "longitude": { "description": "The longitude in degrees. It must be in the range [-180.0, +180.0].", "format": "double", "type": "number" } }, "type": "object" }, "MapValue": { "description": "A map value.", "properties": { "fields": { "additionalProperties": { "$ref": "#/$defs/Value" }, "description": "The map's fields. The map keys represent field names. Field names matching the regular expression `__.*__` are reserved. Reserved field names are forbidden except in certain documented contexts. The map keys, represented as UTF-8, must not exceed 1,500 bytes and cannot be empty.", "type": "object" } }, "type": "object" }, "Pipeline": { "description": "A Firestore query represented as an ordered list of operations / stages.", "properties": { "stages": { "description": "Required. Ordered list of stages to evaluate.", "items": { "$ref": "#/$defs/Stage" }, "type": "array" } }, "required": [ "stages" ], "type": "object" }, "RequestOptions": { "description": "Options for a request.", "properties": { "requestTags": { "description": "Optional. The request tags for the request. Request tags are user-provided strings used for usage monitoring, cost management, and observability. Callers can associate custom application context (such as component, microservice, feature name, or operation type) with database requests. These tags are collected and aggregated in usage and monitoring reports, allowing billable operations and usage metrics to be sliced and analyzed by tag. These tags *only* show up in monitoring and are visible in administrative operations (such as usage reports). They do not affect data storage, query semantics, or request execution. Cardinality and Best Practices: - Request tags are most effective when using a bounded set of distinct values (e.g., fewer than 100 distinct tags across an entire database). Using a large number of distinct tags may result in tags being omitted from top usage dashboards. - Use structured identifiers (for example: `app=cart`, `env=prod`, `service=checkout`) and avoid high-cardinality values such as UUIDs, request IDs, timestamps, user IDs, or document keys. - Do not include sensitive data or personally identifiable information (PII) in request tags, as they show up in administrative monitoring. The tags are processed as follows: - Leading and trailing whitespace is trimmed. - Empty tags (after trimming) are filtered out. - Truncated to a maximum of 510 characters. - Deduplicated within the same request. - Limited to a maximum of 50 tags per request (excess tags are silently discarded).", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "Stage": { "description": "A single operation within a pipeline. A stage is made up of a unique name, and a list of arguments. The exact number of arguments & types is dependent on the stage type. To give an example, the stage `filter(state = \"MD\")` would be encoded as: ``` name: \"filter\" args { function_value { name: \"eq\" args { field_reference_value: \"state\" } args { string_value: \"MD\" } } } ``` See public documentation for the full list.", "properties": { "args": { "description": "Optional. Ordered list of arguments the given stage expects.", "items": { "$ref": "#/$defs/Value" }, "type": "array" }, "name": { "description": "Required. The name of the stage to evaluate. **Requires:** * must be in snake case (lower case with underscore separator).", "type": "string" }, "options": { "additionalProperties": { "$ref": "#/$defs/Value" }, "description": "Optional. Optional named arguments that certain functions may support.", "type": "object" } }, "required": [ "name" ], "type": "object" }, "Value": { "description": "A message that can hold any of the supported value types.", "properties": { "arrayValue": { "$ref": "#/$defs/ArrayValue", "description": "An array value. In Standard edition databases, an array value cannot directly contain another array value, though it can contain a map which contains another array. In Enterprise edition databases, an array value can contain another array value. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue." }, "booleanValue": { "description": "A boolean value. Only one of the following fields should be set: this field, nullValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "type": "boolean" }, "bytesValue": { "description": "A bytes value. In Standard edition databases: * The value must not exceed 1 MiB - 89 bytes. * Only the first 1,500 bytes are considered by queries. In Enterprise edition databases, there is no limit on the size of the value. However, it is still subject to document and index entry size limits. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "format": "byte", "type": "string" }, "doubleValue": { "description": "A double value. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "format": "double", "type": "number" }, "fieldReferenceValue": { "description": "Value which references a field. This is considered relative (vs absolute) since it only refers to a field and not a field within a particular document. **Requires:** * Must follow field reference limitations. * Not allowed to be used when writing documents. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, variableReferenceValue, functionValue, pipelineValue.", "type": "string" }, "functionValue": { "$ref": "#/$defs/Function", "description": "A value that represents an unevaluated expression. **Requires:** * Not allowed to be used when writing documents. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, pipelineValue." }, "geoPointValue": { "$ref": "#/$defs/LatLng", "description": "A geo point value representing a point on the surface of Earth. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue." }, "integerValue": { "description": "An integer value. Only one of the following fields should be set: this field, nullValue, booleanValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "format": "int64", "type": "string" }, "mapValue": { "$ref": "#/$defs/MapValue", "description": "A map value. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue." }, "nullValue": { "description": "A null value. Only one of the following fields should be set: this field, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "enum": [ "NULL_VALUE" ], "type": "string", "x-google-enum-descriptions": [ "Null value." ] }, "pipelineValue": { "$ref": "#/$defs/Pipeline", "description": "A value that represents an unevaluated pipeline. **Requires:** * Not allowed to be used when writing documents. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue." }, "referenceValue": { "description": "A reference to a document. For example: `projects/{project_id}/databases/{database_id}/documents/{document_path}`. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "type": "string" }, "stringValue": { "description": "A string value. In Standard edition databases: * The string, represented as UTF-8, must not exceed 1 MiB - 89 bytes. * Only the first 1,500 bytes of the UTF-8 representation are considered by queries. In Enterprise edition databases, there is no limit on the size of the value. However, it is still subject to document and index entry size limits. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "type": "string" }, "timestampValue": { "description": "A timestamp value. Precise only to microseconds. When stored, any additional precision is rounded down. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, variableReferenceValue, functionValue, pipelineValue.", "format": "date-time", "type": "string" }, "variableReferenceValue": { "description": "Pointer to a variable defined elsewhere in a pipeline. Unlike `field_reference_value` which references a field within a document, this refers to a variable, defined in a separate namespace than the fields of a document. Only one of the following fields should be set: this field, nullValue, booleanValue, integerValue, doubleValue, timestampValue, stringValue, bytesValue, referenceValue, geoPointValue, arrayValue, mapValue, fieldReferenceValue, functionValue, pipelineValue.", "type": "string" } }, "type": "object" } }, "description": "The request for Firestore.CreateDocument." }
Connections
streamable-http
https://firestore.googleapis.com/mcp