Setting the issue. One moment.
Contents
Issue No. 40mongodb · Official
mongodb /agent-skills
Use the official MongoDB Skills with your favorite coding agent to build faster.
8 chapters · 46 minutes · 10,153 words
Install and provenance
npx skills add mongodb/agent-skills/plugin marketplace add mongodb/agent-skills- Owner
- mongodb · Organization
- Licence
- Apache-2.0
- Last updated
- Published from
- github.com/
mongodb/ agent-skills
Typeset in this issue’s own colours, resolved from the awesome-design-md registry.
Front matter
From the READMEMongoDB Agent Skills
Collection of official MongoDB agent skills for use in agentic workflows. For more information, refer to the MongoDB Agent Skills documentation (opens in a new tab).
This README covers the mongodb-atlas plugin, which connects your agent to the MongoDB-hosted Atlas MCP server over HTTP using OAuth. It bundles the official MongoDB agent skills for writing queries, designing schemas, optimizing queries, using Atlas Search and Vector Search, and more.
Connecting to MongoDB Community or Enterprise Advanced? For self-managed deployments, use the
mongodbplugin instead — it runs the MongoDB MCP server locally and connects to your own deployment. See Community & Enterprise Advanced setup (opens in a new tab) for installation and configuration instructions.
The mongodb-atlas plugin is available on Claude, Cursor, Codex, GitHub Copilot (CLI and VS Code), and Grok.
Installation
Claude
Install mongodb-atlas from the Claude marketplace (opens in a new tab), or run the following command from a Claude session:
-
Install the plugin:
/plugin install mongodb-atlas -
Follow the prompts to complete the installation, then run
/reload-pluginsto activate it.
Cursor
Install mongodb-atlas from the Cursor marketplace (opens in a new tab), or run the following command from a Cursor session:
-
Install the plugin:
/add-plugin mongodb-atlas -
Follow the prompts to complete the installation.
Codex
-
Open the plugins browser:
/plugins -
Find the
mongodb-atlasplugin and install it.
GitHub Copilot CLI
-
Install the plugin:
copilot plugin install mongodb-atlasTo browse first, run
copilot plugin marketplace browse.
VS Code
Open the Extensions view (⇧⌘X / Ctrl+Shift+X), search for @agentPlugins,
find mongodb-atlas, and select Install.
Grok
-
Open the marketplace browser in Grok Build:
/marketplace -
Find
mongodb-atlasand pressito install it.
Authentication
The mongodb-atlas plugin connects to the MongoDB-hosted Atlas MCP server using OAuth. The first time your agent uses the server, you’ll be prompted to sign in to MongoDB Atlas in your browser.
Installing the skills directly
The methods below install just the agent skills — the same skills both plugins bundle — for agents or workflows that don’t use a plugin marketplace. They don’t configure an MCP server; to add one, run npx "mongodb-mcp-server@latest" setup, which can configure either the hosted Atlas MCP server or a self-managed deployment. Installing the mongodb-atlas or mongodb plugin just does this for you as a convenience (bundling the MCP configuration); for self-managed specifics, see Community & Enterprise Advanced setup (opens in a new tab).
Vercel’s Agent Skills Directory
https://skills.sh/ (opens in a new tab) is a popular directory and CLI that automates installing skills:
npx skills add mongodb/agent-skillsLocal install from repository
-
Clone the repository:
git clone https://github.com/mongodb/agent-skills.git -
Copy the
skills/directory to the location where your coding agent reads its skills or context files. Refer to your agent’s documentation for the correct path.
Colophon
How this issue was made- Source
- github.com/mongodb/agent-skills, branch
main, last pushed 7 August 2026. - Licence
- Apache-2.0 — the text of every chapter is reproduced unmodified, frontmatter included, under the upstream licence.
- Discovery
- 8 chapters found by walking the repository tree for
SKILL.md, not by matching a directory convention. 2 distinct layouts observed:skills/*/SKILL.md,tools/*/SKILL.md. - Duplicates collapsed
- 26 mirror copies folded into their canonical chapter — republished for Alternate. Copies match on content hash and on position once a leading per-agent prefix is stripped, because the same skill is routinely shipped under a dozen agent directories with a dozen different hashes.
- Issue colours
- Resolved from the awesome-design-md registry — hue 291°, chroma 0.190. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.
- Typefaces
- Display: Euclid Circular A is not available to us; set in Geist.
- Body: Euclid Circular A is not available to us; set in Geist.
- Mono: Source Code Pro is not a face we ship; the reader's own choice is used.
- Heading repairs
- 1 repair applied to the front matter so the document has one
h1and no skipped levels:- Shifted “12 headings” from h1 to h2 so the chapter title is the only h1.
- Spec compliance
- Every chapter satisfies the Agent Skills specification’s frontmatter rules.
- Images
- Images inside a chapter come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.
- Marketplace
- A plugin manifest is published at
.claude-plugin/marketplace.jsonby MongoDB, declaring 2 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree. - Signal
- Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.
- Agent surfaces
- The whole issue is available as one markdown document at
/mongodb/agent-skills.md, and each chapter at its own.mdURL. - Publication
- Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.