couchdb_create_document

Create new documents in CouchDB databases by specifying database name and JSON document data, with optional custom document ID.

Instructions

Create a new document in a database

Input Schema

TableJSON Schema

Name	Required	Description
`database`	Yes	Name of the database
`document`	Yes	Document data as JSON object
`doc_id`	No	Optional document ID (if not provided, CouchDB generates one)

Implementation Reference

couchdb_mcp_server.py:347-365 (handler)

The actual handler implementation that creates a document in CouchDB. It accepts a database name, document data, and optional document ID. Uses db.save() to create the document, merging the doc_id if provided.

async def _create_document(self, database: str, document: dict, doc_id: str | None = None) -> list[TextContent]:
    """Create a new document."""
    try:
        db = self._get_server()[database]
        if doc_id:
            doc_id, rev = db.save({"_id": doc_id, **document})
        else:
            doc_id, rev = db.save(document)

        result = {
            "id": doc_id,
            "rev": rev,
            "message": "Document created successfully"
        }
        return [TextContent(type="text", text=json.dumps(result, indent=2))]
    except KeyError:
        return [TextContent(type="text", text=f"Database '{database}' not found")]
    except Exception as e:
        return [TextContent(type="text", text=f"Error creating document: {str(e)}")]

couchdb_mcp_server.py:91-112 (schema)

Tool schema registration defining the input structure for couchdb_create_document. Requires 'database' and 'document' parameters, with optional 'doc_id'.

Tool(
    name="couchdb_create_document",
    description="Create a new document in a database",
    inputSchema={
        "type": "object",
        "properties": {
            "database": {
                "type": "string",
                "description": "Name of the database",
            },
            "document": {
                "type": "object",
                "description": "Document data as JSON object",
            },
            "doc_id": {
                "type": "string",
                "description": "Optional document ID (if not provided, CouchDB generates one)",
            },
        },
        "required": ["database", "document"],
    },
),

couchdb_mcp_server.py:272-277 (registration)

Tool call routing that maps the 'couchdb_create_document' tool name to its handler method, extracting arguments from the request.

elif name == "couchdb_create_document":
    return await self._create_document(
        arguments["database"],
        arguments["document"],
        arguments.get("doc_id")
    )

CouchDB MCP Server