Skip to main content
Your agent can run commands against your MongoDB database — finding documents, running aggregations, inserting records, and updating data — all in plain English. Point it at your database with a connection string and ask in natural language; the agent translates your request into MongoDB commands and returns the results. Unlike read-only data integrations, what the agent can do is governed entirely by the database user in your connection string. Connect with a read-only user and the agent can only read; connect with a read-write user and it can also insert, update, and delete. You stay in control by choosing the permissions of the user you connect with.

​
How to enable

Go to Settings → Capabilities and enable MongoDB, then link a workspace secret containing your connection string. The same secret can be reused across agents and teams.

​
What you need

All the agent needs is a standard MongoDB connection string (URI), for example:
The connection string is stored as an encrypted workspace secret. It includes the database user’s credentials, so the user’s permissions determine exactly what the agent is allowed to do.
Create a dedicated database user for the agent with only the permissions it needs. If the agent should only answer questions about your data, give it a read-only user. If it should also maintain records, give it read-write access to the relevant database.

​
Default database

The capability card has an optional Default Database field. This is the database the agent uses when a request doesn’t name one explicitly.
  • If set — the agent works against that database by default, so you can just ask “how many orders do we have?” without naming the database every time.
  • If left empty — the agent must specify a database on every command. Set a default if your agent mostly works with a single database.
The agent can always target a different database when you ask it to, regardless of the default.

​
Which MongoDB can I use?

Any MongoDB database that accepts a standard connection string works — self-hosted, MongoDB Atlas, or any managed provider. If you don’t have a database yet, you can start for free with MongoDB Atlas, MongoDB’s hosted service, which offers a free tier that’s plenty for getting started. You’re not locked in — the same connection string approach works with any MongoDB instance, so you can move to a paid tier or your own infrastructure later.

​
IP allowlisting

If your database restricts access by IP address (for example, MongoDB Atlas network access rules), allow Abundly’s outbound IP address:
Enterprise customers connect from a different, dedicated IP address. If you’re an enterprise customer and need to allowlist Abundly, contact us and we’ll provide your specific address.

​
Example use cases

  • Ask questions about your data — “How many active users signed up in the last 30 days? Use the analytics database in MongoDB”
  • Reporting — “Every Monday, count last week’s orders by status and post a summary to Slack”
  • Maintaining records — “Add this support ticket to the tickets collection” (with a read-write user)
  • Exploration — “List the collections in our app database and show me a sample document from the users collection”
  • Data checks — “Find any orders in MongoDB with a missing customer ID and flag them”

​
How to connect MongoDB

1

Create a database user

In your MongoDB provider (e.g. Atlas) or your self-hosted instance, create a database user for the agent. Grant only the permissions it needs — read-only if the agent should only query, read-write if it should also modify data.
2

Allowlist Abundly's IP (if required)

If your database restricts access by IP, add Abundly’s outbound IP 34.51.233.91 to the allowlist. Enterprise customers should contact Abundly for their dedicated address.
3

Configure in Abundly

Go to Settings → Capabilities, enable MongoDB, and create a new workspace secret of type MongoDB containing your connection string. Optionally set a Default Database so the agent doesn’t need it specified on every request.

​
Learn more

Agent databases

Store and query structured data inside Abundly — no external database needed.

BigQuery

Query and explore your Google BigQuery data from the agent.

Snowflake

Query and explore your Snowflake data warehouse from the agent.