Couchbase
couchbase.comCouchbase Capella is a cloud database.
Can an AI agent use Couchbase? Yes, in a browser. Our agent got into Couchbase on its own in 8 minutes and did all 8 of its core tasks.
From finding it to leaving
What an agent managed without a person, at each step.
- On its own
Find
Docs it can act on: llms.txt, an OpenAPI and an MCP server.
462 doc pages read
- On its own
Get in
Sign-up in a browser.
8 minutes
- On its own
Use
Did: create and delete a free database cluster; add and read documents, run queries and search, including vector search.
8 of 8 core tasks
- Reaches the checkout
Pay
Stopped at the card form.
- On its own
Leave
Nothing to cancel, deletes its account.
Getting in
1 of 5 ways in worked without a person.
The way that worked
Email and password8 minutes
- An inboxNeeded
- A browserNeeded
- A personNot needed
- Agent on a serverAPI, MCP, CLINoStops at sign-up: it works only in a browser.
- Assistant in its own browserLike ChatGPT agentPartlySigns up, confirms its email and does all of the core work. Payment: reaches the checkout, stopped at the card form.
- Signed agentKnown to CloudflareYesThe sign-up page opens.
Every way in
| Way in | What happened | Why |
|---|---|---|
| Email and password | Worked | |
| Runs locally, no account | Not tried | Not part of this drive |
| Continue with GitHub | Not tried | Not part of this drive |
| Continue with Google | Not tried | Not part of this drive |
| Added by an admin | Not tried | Needs a person's account |
What an agent can do with Couchbase
All 8 core tasks done, and 8 of 10 others.
Core tasks
- done there
- offered, not tried
| Task | Result | Through |
|---|---|---|
| Create a database cluster | Done | API: done thereCLI: offered, not tried |
| Create or update a document (key-value) | Done | API: done thereMCP: done thereCLI: offered, not tried |
| Delete a document | Done | API: done thereMCP: done thereCLI: offered, not tried |
| Run a SQL++ (N1QL) query over a database | Done | API: done thereMCP: done thereCLI: done there |
| Run a full-text search query | Done | API: done there |
| Run a vector search | Done | API: done there |
| List databases/buckets and read their schema | Done | API: done thereMCP: done thereCLI: offered, not tried |
| Sync a local/mobile database with the cloud | Done | API: done there |
Reliability
100of 100
Core tasks that worked on all 3 runs
Handles mistakes
94of 100
Clear errors, retries without duplicates, honest limits
Surface tested
54of 100
Documented routes, tools and commands run and checked
Docs accuracy
90of 100
Documented operations that behaved as the docs say
Docs completeness
86of 100
How fully the docs describe each operation
What it can't do, and why
- Get the first API key without a browser The first key can only be made in the web page.
- Upgrade to a paid plan Payment is a card typed into an in-app form.
- Use backups service, analytics, eventing and scaling on the free tier These need a paid plan.
- Read the pricing page Cause not confirmed in this drive.
8 of 10 other tasks done
- Create a table/collectionDone
- Set row-level security / RBAC roles for usersDone
- Back up a databaseDone
- Find slow or inefficient queriesDone
- Add knowledge/tools to an AI agent via Agent CatalogDone
- Invite a member / manage organization usersDone
- Create an API keyDone
- Read usage and quotas / billingDone
- Restore a database from backupPartly
- Export data to a warehouse / connectorPartly
- Set up cross data-center replication (XDCR)Paid plan
- Create a database trigger / eventing function: These need a paid plan.Paid plan
- Run an analytics (OLAP) query: These need a paid plan.Paid plan
- Resize/scale database computePaid plan
- Add a read replica / server groupPaid plan
- Deploy a hosted AI agent / modelPaid plan
- Encrypt data with a customer-managed keyPaid plan
- Configure SAML/LDAP SSOPaid plan
- Read the audit logPaid plan
The plans they need
- Back up a database (managed backups)paid
- XDCRpaid
- Eventingpaid
- Analyticspaid
- Resizepaid
- Replicas / server groupspaid
- Hosted modelpaid
- CMEKpaid
- SSOpaid
- Audit logEnterprise
Paid-plan tasks don't count toward the level. The drive used the free plan.
Surface audit: 426 documented operations, 230 run, 206 passed, 24 not as documented, 150 blocked (sandbox or plan limits), 4 not run for time, 45 left out to stay safe.
How an agent connects
MCP, API, OpenAPI, CLI, SDK and llms.txt found.
MCP server
All testedOfficial server. Self-hosted, 33 tools.
24 tools across its docs
API
168 testedREST Management API v4, 343 operations; Data API, 18 operations.
361 operations across its docs
OpenAPI
Yes3.0.2.
CLI
20 testedcbsh 1.4.0; cbq, cbimport, cbexport, cbbackupmgr 8.0.3; agentc 1.1.5.
22 commands across its docs
SDK
All testedNode.js couchbase 4.7.1.
14 methods across its docs
llms.txt
YesAgent payments
None foundThe checkout: Reached the card form and stopped: Pay-as-you-go; Checkout: a Stripe card form; An invisible bot check loaded at checkout; Wallets: Google Pay.
Docs
No gaps in what we readCovers getting started, auth, error codes and code examples.
11 of 16 documented ways to do the core work worked when tried.
docs.couchbase.com/home/index.html
462 of 5,457 pages read
Tips for agent builders
- Sign up at cloud.couchbase.com/sign-up with email and password, then make one Management API key in Settings > API Keys; everything after that works by API at https://cloudapi.cloud.couchbase.com/v4 with the key's token as Bearer.
- Use the freeTier paths for buckets on a free cluster (POST .../buckets/freeTier); the general bucket path needs replicas: 0 and its delete answers with a misleading 403.
- Turn on the Data API (PUT .../dataAPI {enableDataApi:true}, ready in about 5 minutes) for plain REST document, query and search calls with database credentials.
- Run the official MCP server with CB_MCP_TRANSPORT=http and CB_MCP_READ_ONLY_MODE=false to get its write tools; it negotiates protocol 2025-11-25 through initialize.
- For cbbackupmgr against Capella, create the repository with --disable-analytics --disable-cluster-analytics --disable-bucket-query --disable-cluster-query.
- Get the cluster CA with GET .../clusters/{id}/certificates for REST calls on ports 18091/18093/18094.
- When rotating an API key, use the returned token (not secretKey) as the Bearer value.
How Couchbase compares
In Databases
1st of 9 Databases products our agent got into on its own.
| Product | Level | Find to leave |
|---|---|---|
| L4 | Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own. | |
| L4 | Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own. | |
| L4 | Find: Partly, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own. | |
| L4 | Find: On its own, Get in: On its own, Use: On its own, Pay: Not reached, Leave: On its own. | |
| L4 | Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own. | |
| L4 | Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own. | |
| L3 | Find: Stopped, Get in: On its own, Use: Partly, Pay: Not reached, Leave: On its own. | |
| L3 | Find: On its own, Get in: On its own, Use: Partly, Pay: Not reached, Leave: On its own. |
Sorted by level, then work done, then time to the first call. How we rank
For the team behind Couchbase
Our agent got through Pay only in part. Prove Couchbase is yours, then see where each issue is, read your safety findings and ask for a free drive after a fix. How to fix each one comes with the Audit.
9 things to fix for agents
Agent blockers: 2 foundAgent surfaces: 27 issues found
- FindClear
- Get inClear
- UseClear
- PayPartly
- LeaveClear
On our standard
18 criteria: against other databases products where we measured 5 or more, otherwise against every product we measured.
- One way to page through listsAhead of most 8 of 10 others (databases products) lower, 2 the same.
- Every way in works for an agentAhead of most 9 of 12 others (databases products) lower, 3 the same.
- Export before leavingAhead of most 7 of 11 others (databases products) lower, 4 the same.
- A request id on every answerAhead of most 4 of 7 others (databases products) lower, 1 the same, 2 higher.
- All validation problems at onceLevel with most 23 of 35 others (every product) the same, 12 higher.
- Spend an agent can see and capBehind most 7 of 12 others (databases products) higher, 5 the same.
- Answers sized for an agentBehind most 6 of 9 others (databases products) higher, 3 the same.
- The best way in is built for agentsBehind most 10 of 12 others (databases products) higher, 1 the same, 1 lower.
All 18 criteria
- Versions an agent can pinLevel with most 8 of 10 others (databases products) the same, 2 lower.
- Fast to the first callThe same as all 9 others (databases products).
- Real status codesThe same as all 11 others (databases products).
- Errors say what to do nextLevel with most 9 of 11 others (databases products) the same, 1 lower, 1 higher.
- WebMCP tools on the web appThe same as all 7 others (databases products).
- Pages fit one fetchLevel with most 9 of 11 others (databases products) the same, 2 higher.
- Docs an agent can navigateLevel with most 9 of 11 others (databases products) the same, 2 higher.
- Limits known before they hitLevel with most 3 of 4 others (databases products) the same, 1 higher.
- A path written for agentsLevel with most 6 of 11 others (databases products) the same, 1 lower, 4 higher.
- Errors a program can readLevel with most 6 of 11 others (databases products) the same, 1 lower, 4 higher.
Where Couchbase fits
- Category
- Tasks
- Wall
- Sign-up or key only in a browserour agent got in another way
Cited in 1 article
Found an error? Tell us on this page or read how corrections work.
Questions people ask about Couchbase
- Can an AI agent sign up for Couchbase on its own?
- Yes, in a browser, without a human. Email + password form at cloud.couchbase.com/sign-up, no CAPTCHA; only a name, email, password and the terms box. No sign-up API.
- Does Couchbase have an MCP server, and can an agent connect to it?
- Yes. Couchbase has an official MCP server. The server is hosted and lists 33 tools. A new agent can get in on its own: in the drive of 25 Oct 2026, our agent signed up, verified and got its key without a person. Through the MCP server, 1 of our agent's 1 attempt worked, not on a core task.
- How does an AI agent get a Couchbase API key?
- In the drive of 25 Oct 2026, our agent got its Couchbase API key in a browser, without a person. The first Management API key is made in the web UI only (Settings > API Keys > Generate Key); with it, further scoped keys are created, used and revoked by API.
- Can an AI agent delete its Couchbase account?
- Yes, over the API, without a browser. Everything we made was deleted by API (App Service, cluster, credentials, keys). The docs only describe deleting an organization through support, which the free tier does not offer; the empty organization record may remain on Couchbase's side.
- Can an AI agent pay for Couchbase?
- Partly. Reaches the checkout: stopped at the card form.
Cite this page
The page as a reference, in plain text, APA and BibTeX.
Cite this
AgentDrives, “Couchbase: AI agent test drive”, 25 October 2026, https://agentdrives.com/tools/couchbase. CC BY 4.0.
AgentDrives. (2026, October 25). Couchbase: AI agent test drive. https://agentdrives.com/tools/couchbase
@misc{agentdrives_couchbase_2026,
author = {{AgentDrives}},
title = {Couchbase: AI agent test drive},
year = {2026},
month = oct,
url = {https://agentdrives.com/tools/couchbase},
note = {Agent test drive, CC BY 4.0},
}Something wrong on this page?
Tell us what's wrong. We check it against the drive and correct the page, with the date.