How to Connect MongoDB Remote MCP to Windsurf

Add MongoDB's remote MCP server to Windsurf in about a minute.

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1ยทhttps://mcp.mongodb.com/mcp

Step-by-step

  1. Edit mcp_config.json
    Add the serverUrl config above to ~/.codeium/windsurf/mcp_config.json and refresh in Cascade.
  2. Authorize
    On first use your client opens a MongoDB OAuth consent screen โ€” approve it and tools become available.
  3. Verify
    Verify in the browser: paste https://mcp.mongodb.com/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

  • A 401 Unauthorized on first connect is normal โ€” the endpoint is OAuth-protected; let Windsurf finish the browser consent flow.
  • If the consent window never opens, remove and re-add the server, then retry.
  • Check the exact challenge at our OAuth debugger.
  • Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Streamable HTTPhttps://mcp.mongodb.com/mcp

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mongodb": {
      "serverUrl": "https://mcp.mongodb.com/mcp"
    }
  }
}

Tools exposed by MongoDB (36)

ToolSafetyDescriptionParameters
list-connections
~32 tok
๐ŸŸข ReadList configured MongoDB connections.โ€”
connect
~33 tok
๐ŸŸข ReadConnect to a MongoDB instance or Atlas cluster.โ€”
list-databases
~31 tok
๐ŸŸข ReadList databases of a connection.โ€”
list-collections
~31 tok
๐ŸŸข ReadList collections of a database.โ€”
collection-indexes
~31 tok
๐ŸŸข ReadList indexes of a collection.โ€”
collection-schema
~32 tok
๐ŸŸข ReadInfer the schema of a collection.โ€”
collection-storage-size
~33 tok
๐ŸŸข ReadGet storage size of a collection.โ€”
db-stats
~27 tok
๐ŸŸข ReadGet database statistics.โ€”
count
~29 tok
๐ŸŸข ReadCount documents matching a filter.โ€”
find
~29 tok
๐ŸŸข ReadRun a find query on a collection.โ€”
aggregate
~29 tok
๐ŸŸข ReadRun an aggregation pipeline.โ€”
explain
~31 tok
๐ŸŸข ReadExplain a find or aggregate query plan.โ€”
insert-one
~28 tok
๐ŸŸ  WriteInsert a single document.โ€”
insert-many
~29 tok
๐ŸŸ  WriteInsert multiple documents.โ€”
update-one
~28 tok
๐ŸŸ  WriteUpdate a single document.โ€”
update-many
~29 tok
๐ŸŸ  WriteUpdate multiple documents.โ€”
rename-collection
~29 tok
๐ŸŸ  WriteRename a collection.โ€”
delete-one
~28 tok
๐Ÿ”ด DestructiveDelete a single document.โ€”
delete-many
~29 tok
๐Ÿ”ด DestructiveDelete multiple documents.โ€”
drop-collection
~28 tok
๐Ÿ”ด DestructiveDrop a collection.โ€”
drop-database
~27 tok
๐Ÿ”ด DestructiveDrop a database.โ€”
create-index
~30 tok
๐ŸŸ  WriteCreate an index on a collection.โ€”
export
~29 tok
๐ŸŸข ReadExport query results to a file.โ€”
mongodb-logs
~30 tok
๐ŸŸข ReadRetrieve MongoDB server logs.โ€”
atlas-list-orgs
~31 tok
๐ŸŸข ReadList MongoDB Atlas organizations.โ€”
atlas-list-projects
~29 tok
๐ŸŸข ReadList Atlas projects.โ€”
atlas-list-clusters
~29 tok
๐ŸŸข ReadList Atlas clusters.โ€”
atlas-inspect-cluster
~31 tok
๐ŸŸข ReadInspect an Atlas cluster.โ€”
atlas-create-cluster
~30 tok
๐ŸŸ  WriteCreate an Atlas cluster.โ€”
atlas-create-free-cluster
~34 tok
๐ŸŸ  WriteCreate a free-tier Atlas cluster.โ€”
atlas-list-db-users
~31 tok
๐ŸŸข ReadList Atlas database users.โ€”
atlas-create-db-user
~32 tok
๐ŸŸ  WriteCreate an Atlas database user.โ€”
atlas-list-access-list
~33 tok
๐ŸŸข ReadList Atlas IP access list entries.โ€”
atlas-create-access-list
~33 tok
๐ŸŸ  WriteAdd an Atlas access list entry.โ€”
atlas-inspect-access-list
~33 tok
๐ŸŸข ReadInspect the Atlas access list.โ€”
atlas-connect-cluster
~34 tok
๐ŸŸข ReadGet connection details for a cluster.โ€”

Connect MongoDB to another client

Other servers for Windsurf

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline261ms
Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~606 tok18 toolsOnline21ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~899 tok30 toolsOnline8ms

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿงฉ MCP App๐Ÿ›ก๏ธ A+~286 tok8 toolsOnline218ms
AWS KnowledgeAmazon Web Services

AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ€” connect and call tools immediately.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline155ms

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~1336 tok43 toolsOnline217ms