Tool reference
Create workspace
Create a new workspace.
Tool name: create_workspace
Cost: Counts against your plan's monthly workspace quota - the same allowance the web app draws on. Nothing is billed per call.
Writes data - confirmation required
This tool creates or changes data. It is not annotated readOnlyHint, so
your MCP client prompts you before it runs, and the server asks for an
explicit confirmation describing exactly what will change. Declining cancels
the call cleanly.
Create a new workspace. Counts against the user's monthly workspace quota.
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
title | string | Yes | - |
description | string | No | - |
landingUrls | string[] | Yes | Landing/seed URLs for the workspace. |
defaultLocation | { id, code, isoCode, name } | No | DataForSEO location reference. Do NOT invent these fields - call search_reference with type="location" (e.g. query="United States") and pass one returned result object here verbatim. |
defaultLanguage | { id, code, isoCode, name } | No | DataForSEO language reference. Do NOT invent these fields - call search_reference with type="language" (e.g. query="English") and pass one returned result object here verbatim. |
Full input JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"landingUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Landing/seed URLs for the workspace."
},
"defaultLocation": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"code": {
"type": "string"
},
"isoCode": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": ["id", "code", "isoCode", "name"],
"description": "DataForSEO location reference. Do NOT invent these fields - call search_reference with type=\"location\" (e.g. query=\"United States\") and pass one returned result object here verbatim."
},
"defaultLanguage": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"code": {
"type": "string"
},
"isoCode": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": ["id", "code", "isoCode", "name"],
"description": "DataForSEO language reference. Do NOT invent these fields - call search_reference with type=\"language\" (e.g. query=\"English\") and pass one returned result object here verbatim."
}
},
"required": ["title", "landingUrls"]
}Response
Full output JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"title": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"defaultLocation": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"code": {
"type": "string"
},
"isoCode": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": ["id", "code", "isoCode", "name"],
"additionalProperties": {}
},
"defaultLanguage": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"code": {
"type": "string"
},
"isoCode": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": ["id", "code", "isoCode", "name"],
"additionalProperties": {}
}
},
"required": ["id", "title", "defaultLocation", "defaultLanguage"],
"additionalProperties": false
}