confluence_get_space
Retrieve details of a Confluence space by providing its space key. Access space information like name, description, and permissions.
Instructions
Get information about a specific Confluence space
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spaceKey | Yes | The key of the space to retrieve |
Implementation Reference
- index.js:458-468 (handler)The handler case in the CallToolRequestSchema switch that dispatches 'confluence_get_space' to the getSpace function
case 'confluence_get_space': { const result = await getSpace(args.spaceKey); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; } - index.js:117-124 (helper)The getSpace helper function that makes the actual API call to Confluence REST API to retrieve space information
async function getSpace(spaceKey) { try { const response = await client.get(`${CONFLUENCE_API_BASE}/space/${spaceKey}`); return response.data; } catch (error) { throw new Error(`Failed to get space: ${error.message}`); } } - index.js:297-310 (schema)The tool registration metadata including name, description, and input schema definition for 'confluence_get_space'
{ name: 'confluence_get_space', description: 'Get information about a specific Confluence space', inputSchema: { type: 'object', properties: { spaceKey: { type: 'string', description: 'The key of the space to retrieve', }, }, required: ['spaceKey'], }, }, - index.js:227-398 (registration)The ListToolsRequestSchema handler where all tools (including 'confluence_get_space') are registered with the MCP server
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ { name: 'confluence_search', description: 'Search Confluence content using CQL (Confluence Query Language). Example queries: "type=page AND title~\\"API\\"", "type=page ORDER BY lastmodified DESC"', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'CQL search query (e.g., "type=page AND title~\\"keyword\\"")', }, limit: { type: 'number', description: 'Maximum number of results (default: 10)', }, spaceKey: { type: 'string', description: 'Optional space key to limit search to a specific space', }, }, required: ['query'], }, }, { name: 'confluence_list_spaces', description: 'List all Confluence spaces accessible to the user', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Maximum number of spaces to return (default: 25)', }, }, }, }, { name: 'confluence_get_page', description: 'Get a Confluence page by ID including its content, version, and metadata', inputSchema: { type: 'object', properties: { pageId: { type: 'string', description: 'The ID of the page to retrieve', }, }, required: ['pageId'], }, }, { name: 'confluence_get_page_by_title', description: 'Find a Confluence page by its title and space key', inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'The exact title of the page', }, spaceKey: { type: 'string', description: 'The key of the space containing the page', }, }, required: ['title', 'spaceKey'], }, }, { name: 'confluence_get_space', description: 'Get information about a specific Confluence space', inputSchema: { type: 'object', properties: { spaceKey: { type: 'string', description: 'The key of the space to retrieve', }, }, required: ['spaceKey'], }, }, { name: 'confluence_create_page', description: 'Create a new Confluence page in a specific space', inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'The title of the new page', }, spaceKey: { type: 'string', description: 'The key of the space where the page will be created', }, content: { type: 'string', description: 'The page content in Confluence storage format (HTML)', }, parentId: { type: 'string', description: 'Optional ID of the parent page (creates a child page)', }, }, required: ['title', 'spaceKey', 'content'], }, }, { name: 'confluence_update_page', description: 'Update an existing Confluence page', inputSchema: { type: 'object', properties: { pageId: { type: 'string', description: 'The ID of the page to update', }, title: { type: 'string', description: 'The new title for the page', }, content: { type: 'string', description: 'The new content in Confluence storage format (HTML)', }, version: { type: 'number', description: 'Current version number of the page (will be incremented)', }, }, required: ['pageId', 'title', 'content', 'version'], }, }, { name: 'confluence_add_labels', description: 'Add labels (tags) to a Confluence page', inputSchema: { type: 'object', properties: { pageId: { type: 'string', description: 'The ID of the page', }, labels: { type: 'array', items: { type: 'string' }, description: 'Array of label names to add', }, }, required: ['pageId', 'labels'], }, }, { name: 'confluence_get_attachments', description: 'Get list of attachments for a Confluence page', inputSchema: { type: 'object', properties: { pageId: { type: 'string', description: 'The ID of the page', }, }, required: ['pageId'], }, }, ], }; });