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: 
mongodb+srv://user:password@cluster.mongodb.net
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: 
34.51.233.91
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.