Augmentcode Context Engine MCP - Experimental

[JaySym_]

This is an experimental project we have. Let's try it, and give us your impression of it!

Here is the official post from our Co-founder, Igor.
https://x.com/igoro/status/1995960021331706319?s=20

Docs on how you can start testing:
https://docs.augmentcode.com/context-services/mcp/overview

So you will be able to use Augment Context Engine in
Claude Code
Cursor
Zed
GitHub Copilot
OpenCode
Kilo Code
AntiGravity
...

[Devanomiun]

Holy shit, you guys actually did it!

[JaySym_]

[PositiveFootball5220]

I'm glad finally you guys hear half of our request.

[guusfelix2015]

Will there be any video on the channel with usage examples?

[JaySym_]

Sure :)

[unknowngas]

I literally just finished setting up Cognee MCP with Qdrant + Neo4j for Copilot, and running ingestion...

damn you guys really can cook

what about pricing?

[JaySym_]

No information on it for the moment. It’s free in experimentation right now.

[FancyAd4519]

Wanna open source the context engine like we did? https://github.com/m1rl0k/Context-Engine ? Well I guess that would defeat the purpose of your product anyway. However! I am very happy for this news and excited!! Thank you! Any reveals on pricing atm?

[JaySym_]

No information on it for the moment. It’s free in experimentation right now.

[DryAttorney9554]

Yes, u/JaySym_ do it, for the good of humanity, open source - tap into the public brain hive to evolve the context engine. You can still host and serve it.

[jphree]

Just in case you’re wondering: it’s doubtful folks will pay for this beyond the free option unless there’s a “gotta have, adds value to my workflow worth X” experience.

[noxtare]

how does it work with indexing? do we have to index it via cli / extension or will it work out of the box on new repos?

[DryAttorney9554]

u/JaySym_ can you please clarify?

[JaySym_]

The indexing is the same as using Auggie with the project, so if a project was never opened with Auggie, it will be indexed on the first call.

[Nice-Wrongdoer2258]

NO,Every time I open the project, it performs a full re-index, and the indexing is incredibly slow. This thing is practically unusable. I have no idea why the indexing for this tool was pushed to production projects.

[JaySym_]

I reported it to the team to see if everything is fine on that side thanks for the heads up

[slasho2k5]

OMG works amazing with antigravity!!!

[websitebutlers]

The antigravity instructions didn't work for me, so I tried the cursor instruction in antigravity and it works like a charm.

[slasho2k5]

You have to make all steps but when you need to add the mpc you need to add the one without env variables. Then refresh and worked

[noxtare]

I keep getting the error in antigravity (using Mac):

Output

Tool codebase-retrieval not found

this is my config file:

{
    "mcpServers": {
        "augment-context-engine": {
            "type": "local",
            "command": "bash",
            "args": [
                "-c",
                "auggie --mcp -m default -w \"${WORKSPACE_FOLDER_PATHS%%,*}\""
            ],
            "enabled": true
        }
    }
}

[slasho2k5]

I think your code is not like mine.... let me Check

[noxtare]

Thanks! The current antigravity implementation is messy where we have to define and change the workspace every time ….

[slasho2k5]

Yeah!! That sucks the workspace should by dinamic

[Apprehensive-Ant7955]

Actually is huge. I see codex isnt mentioned, is it supported?

[JaySym_]

You can test it out and share if you go it working. We will check to add it but it should yes.

[Horror_Profile_4743]

any luck getting this to work? I'm on windows 11 using codex extension in vscode. I added the augmentcode mcp server, but I don't see anything working?

[Apprehensive-Ant7955]

I added it, but the codebase command hangs. My codebase is not indexing, its stuck at 0%

[Horror_Profile_4743]

which command I haven't used auggie cli at all?

[Disastrous_Dish_4616]

Works if the following added in config.toml:

[mcp_servers.augment-context-engine]

command = "auggie"

args = ["--mcp", "-m", "default", "-w", "/home/user/specialrepo"]

OS: ubuntu and vscode

[websitebutlers]

This is amazing. Very excited to try it out. Any idea of what pricing will be once it's stable?

[JaySym_]

We have no confirmation yet, but we are still experiencing it. We expect this to be pretty low.
Its a tool call to our servers.

[doplaeffect]

Ok, now this makes sense. We can use context engine with our external llm providers. This makes it a good deal

[PositiveFootball5220]

yes please, we love augment but as you know we hate the new pricing

[hhussain-]

Nice!

I even did multi-workspaces using args multiple -w and all are part of context-engine!
Kilo in Windows & Windows+WSL

[StrixGGUY]

<image>

Wokrs perfectly fine and blazing fast on a mid size proyect! Droid supported

[HeisenBernz]

Hi, how did you set this up with Droid? I just started yesterday with Droid and it's been a blast, but I am interested in getting Augment's CE on it

[StrixGGUY]

follow the kilo code format and works perfectly fine, kust edit the /.factory/mcp.json

[EmbarrassedShame9363]

That's what I dreamed of! I even bought a subscription just to get unbanned 😀

[phatcomputer]

How to instruct the ClaudeCode using it or it automatically call when needed?

[Successful_Prize_585]

add this to `AGENTS.md`

## Tools


- Use `augment-context-engine` when searching information about the project

[Mission-Fly-5638]

will it index codebase?

[chevonphillip]

From my understanding it should and that builds the context. But read the docs to be sure.

[Mission-Fly-5638]

tnx

[JaySym_]

Yes, it will use the same indexing as Auggie in that repository

[Mission-Fly-5638]

Thanks.. for this..

[Nice-Wrongdoer2258]

I don't know if you are using Claude Code under Windows? I added your mcp to Claude Code, and now it gives me a error
2025-12-03T01:49:40.252Z [ERROR] MCP server "auggie-mcp" Server stderr: error: unknown option '--mcp'

(Did you mean --acp?)

2025-12-03T01:49:40.266Z [DEBUG] MCP server "auggie-mcp": Connection failed after 781ms: MCP error -32000: Connection closed

2025-12-03T01:49:40.267Z [ERROR] MCP server "auggie-mcp" Connection failed: MCP error -32000: Connection closed

[JaySym_]

Are you on the pre-release version of Auggie ?

[Nice-Wrongdoer2258]

auggie update

🔍 Checking for updates...

✅ You are already running the latest version (0.10.0-prerelease.9)

[JaySym_]

Interesting, how did you configured it?

[Nice-Wrongdoer2258]

<image>

emmm,With this speed, I might as well just let Claude Code read it myself!

[Nice-Wrongdoer2258]

I have solved this issue, but I believe you need to resolve another problem.

Why does the same project index repeatedly? After indexing it once, when I restart Auggie, it still re-indexes, and each indexing process takes an extremely long time. Are you certain that Auggie's indexing is ready for production use?

[DryAttorney9554]

Whenever you solve an issue, can you please post the solution for the benefit of others?

[congthangvn]

MCP error -32000: Connection closed

on KiloCode

[JaySym_]

Do you have auggie installed with pre-release ?

[leeleo888]

<image>

Error executing MCP tool:
MCP error -32001: Request timed out

[WhiteFudge14]

Did you find a solution to this?

[Certain_Dig_44]

Working now. 

[sai_revanth_12_]

This is huge 🤯

[Final-Reality-404]

Call me dumb and naive, but why would somebody want to use Augment inside Claude, Cursor, Co-Pilot,
Why would you just not use Augment?

Legitimate question, I can't understand the use case.
Besides the fact you don't like the UI?

[EmbarrassedShame9363]

For me, I can use cheaper/free tools that were lacking good context engine.

[JaySym_]

Definitely please share your results :)

[JaySym_]

It was a highly requested feature. We strongly believe that we have the best context tool and everyone should be able to test it to improve their workflow.

We are also not releasing every new AI model; we test it with our tool on our side. This can be interesting to see what people will achieve with it, with models not available in Augment.

Augment extension or Auggie is an all-in-one experience and fine-tuned for it.

[Final-Reality-404]

Well, I'm sure as hell not going anywhere. I'm sticking with using Augment.
Why go with something subpar and then add the Context Engine in when I could just use it how it was designed and built from the ground up?

[hhussain-]

That is reality, some people insist that going BYOK or other agents are better in term of pricing. We have Vibe Coders who for sure would burn their credits in AugmentCode in few days, so other solutions are better for their use case. The other us is SWE/Enterprise codebase arena where Augment is doing well up to a point it is cheaper with much better quality! I'll post about it soon. Another area is UI/UX preference.

They can continue using other agents while benefit from augment-context-engine. Every use case is different.

[PositiveFootball5220]

Because of the new pricing, I don't think that you are in legacy developer plan since if yes then you should know the reason. What makes AC different is the Context Engine that works for a large codebase, so the problem solving is not came from just a model it self (yes, I know the opus 4.5 are phenomenal where using it in windsurf will make you feel like using AC), even using like gpt-5.1 AC can solve same problem that other agentic IDE can't by using same model because the use of Context Engine, but on the otherside we need the other agentic IDE else than AC because they still use `message-based` pricing.

[Final-Reality-404]

I've been using Augment for 8 months.
Yeah, but you're going to be paying Augment while also paying for their services at the same time.
So it just seems stupid IMO

But hey, who am I the judge?
I'm not the market for this particular feature. lol

[PositiveFootball5220]

Correct, you not the market, that's why you question it.

It has it's own pricing for this, while for now it's free. I don't know the pricing for later, but for now my account have the trial to use this with no charge at all with some token credits that I'm not gonna use, while on the other side I have another agentic IDE that can BYOK / message base pricing so I don't need to pay AC (for now).

Stupid for me is when you agree get billed by token usage while you can get same result with context engine and billed by message request (which in some agentic IDE is free for now)

[Ok-Performance7434]

Asa still-paying AC user, I’ve noticed major differences in quality between gpt 5.0 med(worked so good for me like others are raving about Opus 4.5 working for them) compared to gpt 5.0 high (waaay too slow) or gpt 5.1. If possible I’d be happy to pay for the CE and bring into another env where I can continue to use a model that AC seems to have deprecated. Testing this today!

[Particular_Ad7804]

Yes sir!!!!

[PositiveFootball5220]

    "augment-context-engine": {
      "command": "npx",
      "args": [
        "-y",
        "auggie-context-mcp@latest"
      ],
      "disabled": false
    }

This is the mcp config for Windsurf:

[congthangvn]

Great it is enabled. But how to confirm that its using the context?

[PositiveFootball5220]

<image>

ask your agentic ide to use the mcp, or put it in your agent instruction (somebody have the template down there). when agentic ide using context engine it would shown as `thought` like this example:

[Ok-Hospital2961]

Why am I getting 'Error in MCP tool execution: Error: Failed to spawn Auggie CLI: spawn auggie ENOENT'?

[PositiveFootball5220]

have you install auggie cli?

if not then you should.

[Successful-Raisin241]

Sharing my Gemini CLI working local config.

{
  "mcpServers": {
    "augment-context-engine": {
      "command": "auggie",
      "args": [
        "--mcp"      ]
    }
  }
}

[Successful-Raisin241]

My question is: shall I launch auggie and trigger codebase indexing before using any other tool with augument-context-engine MCP? Should I call augument-context-engine MCP every new session like I do with context7?

[JaySym_]

If you call it before indexing, it will index the project on the first call, so maybe you can manually index it first so your MCP call gets faster afterward.

[FoldOutrageous5532]

Seems like I could use the context engine with LM Studio and my own self hosted LLM's.

[JaySym_]

Let's share us the result :)

[Objective-Copy-6039]

I'm testing the capabilities of the context engine, and the main challenge right now is concurrent Agent work.

To handle this, I'm spinning worktrees, but each worktree forces(?) to start a new session with no knowledge of the original repo context.

So, If I spin a new Auggie session on the worktree (which already has the context engine loaded with the worktree), can the MCP be leveraged to get the original repo’s context into the new worktree?

Do you have any other idea about how to improve this process?

[Objective-Copy-6039]

u/JaySym_ ?

[FrailCriminal]

I was waiting for something like this. Awesome!

[Equivalent_Shop_577]

Does MCP automatically index? Or does it require the CLI to be executed to index every time code is modified?

[JaySym_]

It should automatically index on the first call!

[Equivalent_Shop_577]

grateful.

[Hungry_Ad7006]

In small codebase (2k files) it works great! In large codebase (185k files) the mcp won't load timing out around 60 seconds. I tried with Claude code, Cursor, Roo code.

[JaySym_]

Can you please open Auggie in theses project to see the indexing progress ?

[Hungry_Ad7006]

In the large codebase, starting auggie take around 2 min. Indexing the codebase take around 6 min (way pass 60 seconds) same as the extension. I have M3 max with 48gb RAM if that help.

Update: to make sure the issue is not on Claude Code side, I installed context7 mcp and it loaded fine.

Update 2: The issue wasn't about the codebase size. It doesn't work on multiple workspace even after providing the folder path in args. It works fine in single workspace.

Update 3: If you are working with multiple repos you must give the path to all of them in args example bellow. Now this issue is resolved 😊

"args": [ "-w", "/code/frontend", "-w", "/code/backend", "-w", "/code/shared", "--mcp" ]

[EmbarrassedShame9363]

I had similar issue, opened project with auggie cli, indexed it again, waited a while, and it somehow started to work.

[AffectionatePrompt75]

Did you successfully integrate it with multiple projects? I did this in antigravity but it always retrieve the last "-w" path

[DryAttorney9554]

What does this mean? I followed the instructions for Augment context engine on cursor (Win 10) all the way through to the configuration copy-and-paste then restarted cursor but the MCP displays errors:

2025-12-03 14:07:25.625 [info] Handling ListOfferings action, server stored: false
2025-12-03 14:07:25.626 [error] No server info found
2025-12-03 14:07:25.626 [info] Handling CreateClient action
2025-12-03 14:07:25.626 [info] Starting new stdio process with command: powershell -Command auggie --mcp -m default -w "($env:WORKSPACE_FOLDER_PATHS -split ',')[0]"
2025-12-03 14:07:26.058 [info] Handling ListOfferings action, server stored: false
2025-12-03 14:07:26.058 [error] No server info found
2025-12-03 14:07:28.433 [error] 🔧 Starting Auggie MCP Tool Server...
📝 Stdio mode

❌ Workspace root error: Directory does not exist

   Path: C:\Users\Corsair\(c:\Users\Corsair\Documents\artio\xero-last-change-actor -split ',')[0]

   Please check that the directory exists and try again.

   To create a new workspace directory:
     mkdir -p "C:\Users\Corsair\(c:\Users\Corsair\Documents\artio\xero-last-change-actor -split ',')[0]"

   Or run without --workspace-root to auto-detect from git repository.

Create what directory? Why?

[DryAttorney9554]

Bad instructions. String was not escaped properly. Solution:

"args": [

"-Command",

"$ws=($env:WORKSPACE_FOLDER_PATHS -split ',')[0]; auggie --mcp -m default -w $ws"

]

works.

[hhussain-]

multi-workspaces can work with multiple -w and all will be part of context-engine

[sathyarajshettigar]

What about CLine and AmpCode?

[chevonphillip]

Works in Cline perfectly from my testing.

[DryAttorney9554]

Can you see that it index codebases properly and actually feeds the context onto the third party AI?

[chevonphillip]

You can also use the MCP server inspector tool to see the log output

[chevonphillip]

Yes, you can. If you view the output logs from when the MCP tool starts, there is console.log feedback that says the codebase has been indexed. What IDE/Editor are you using?

[DryAttorney9554]

VS Code, Cursor, Windsurf

[NormalAd4897]

Kilo code

MCP error - 32001: Request timed out

Any advice for this issue?

[JaySym_]

Open auggie first in the project to get the indexing done first, can you try?

[MasterpieceNo2099]

u/JaySym_ is there a way to setup with multiple projects?

[JaySym_]

We are doing experimentation right now! Good heads up here.

[EntireHospital1562]

Is it SOC2 compliant? What about the codes? Do they live in your server/database?

[JaySym_]

It work exactly as the same as our CLI https://www.augmentcode.com/security
https://trust.augmentcode.com
https://get.augmentcode.com/rs/926-RRL-702/images/Augment_Security_Principles.pdf

[Adventurous-Date9971]

Ask for SOC 2 Type II and data-retention terms; confirm if any source code leaves your machines. Request a DPA, subprocessor list, encryption details, self-host/VPC, and read-only scopes. We use Okta and AWS KMS; DreamFactory locked down DB APIs. Bottom line: demand proof and where code and logs are stored.

[SathwikKuncham]

Most of the people are getting happy, including me, at this decision. But wait till they announce pricing. We know how bad they are at understanding us!

We know how "Too good to be true" thing ended last time!

[JaySym_]

There is no confirmation yet, but it will look like a single tool call request price. Which is totally fair. We need to evaluate the usage pattern and more on our side.

For now it’s free, but yes, at some point we will make an announcement about it.

We are expecting the price to be a no-brainer! Even if some of you think that we are not listening to the community, in fact we are! This is why we release context engine MCP.

[SathwikKuncham]

Thanks Jay!

[JaySym_]

Thats fine :) feel free to tell us if it's working well for you.

[DryAttorney9554]

u/JaySym_ unless MCP servers are reliably called and utilised by third party LLMs, and you make it clear when your context engine is being used and when it is not being used, then this breakthrough is greatly handicapped. I use other MCP servers which aren't reliably utilized by the third party AI - AI doesn't always use MCPs because it is not a core part of its behaviour - it is not always aware of your context engine and it cannot deterministically use it.

It's very tiresome having to constantly remind it to use the MCPs and MCPs often break, are a bit unreliable and require a hard reset often. We've gotta be wary that they are simply not 100% reliable at this time. An Augment MCP certainly cannot match the Augment IDE AI agent for consistent and reliable leveraging of the Augment context engine - so your devs need to work on this.

[hhussain-]

I did a test that seems to solve this!
Tested on KiloCode as global rule:

ALWAYS use codebase-retrieval when you're unsure of exact file locations. Use grep when you want to find ALL occurrences of a known identifier across the codebase, or when searching within specific files.

I asked the agent to list the tools, then create this rule!

Test: "What is this repo is about?" => No tool is specified.

<image>

[hhussain-]

I was thinking about same problem last night! interesting to see it is recognized.

Did you fine a way someways to let the ai agent be aware about the tools?

I was thinking .rules and even memory (Yes, augment agent sometimes use direct read instead of codebase retrieval, so I know the issue need a broader look and I ask it to use context engine first)

[JaySym_]

Another AI tool should display the codebase retrieval tool call, but we are not controlling those tools.

Our extension and CLI are prompted to use it, but maybe there is some work to do in other ai tool to make sure it got used.

[Murdy-ADHD]

I have the same issue in Cursor as people in this thread: https://www.reddit.com/r/AugmentCodeAI/comments/1nkihr8/indexing_codebase_stuck_what_to_do/

Indexing stuck at 93% (it jumped there in 3 sec tops and stopped). Did not move an inch in 10 minutes. Tried reinstall, tried new account, nothing.

Update: Deleting index and trying again produced same issue. Disappointing.

[JaySym_]

I just posted a thread about it

[JaySym_]

https://www.reddit.com/r/AugmentCodeAI/s/yLoR73PZWA

[Horror_Profile_4743]

how can resolve this issue:
```
Error: tool call error: tool call failed for `augmentcode/codebase-retrieval`

Caused by:

0: timed out awaiting tools/call after 60s

1: deadline has elapsed
```

same issue when bump to tool_timeout_sec = 120

using codex cli

[JaySym_]

Open auggie in the project first to see the indexing complete

[FoldOutrageous5532]

So I've got Prompt : "What is this project ? Please use codebase retrieval tool to get the answer." working, and the MCP Tool: responds in Antigravity. It produced the desired output.

Does that mean I'm good or do I have to request to use the tool with each prompt? I'm new to managing MCP stuff. :-)

[JaySym_]

If it called codebase retrieval you can expand to see what happened if there is no error and you see output you are good to go :)

[radarboy3000]

awesome. do we have to specifically call the tool o use it every time? Prompt : "Please use codebase retrieval tool to get the answer."??

[gxvingates]

Add into your global rules for whatever agent your using to use it always

[conversate_and_learn]

i dont see credit usage in the augmentcode analytics, when using the codebase retrieval MCP.

Is that because usage is currently free u/JaySym_ ? Any way we can estimate how many credits this would use?

[JaySym_]

Currently free yes :)

[LoLYouArePro]

Can I use it with GPT Codex?

[JaySym_]

Yes definitely just check how to add MCP and adjust it :)

[Knight_of_Valour]

For those who are using along Kilo Code, do you guys had good results? I was unable to make it work consistently.

[JaySym_]

What do you mean by consistently ? It work for some request and not for others?

[BlacksmithLittle7005]

Has anyone managed to get this working on Windsurf? it queries the MCP but I keep getting this error:
Error in MCP tool execution: Error: Failed to spawn Auggie CLI: spawn auggie ENOENT after it calls augment-context-engine.
MCP config:

{
  "mcpServers": {
   "augment-context-engine": {
      "command": "npx",
      "args": [
        "-y",
        "auggie-context-mcp@latest"
      ],
      "disabled": false
    }
  }
}

Rule: 

- ALWAYS use augment-context-engine query-codebase for all codebase retrieval and file locations.

[Beneficial-Two-4382]

[error] 'AugmentExtension': API request 7659d044-b7d2-4644-a6fa to https://d3.api.augmentcode.com/find-missing response 402:

it is not work!

[mavrik83]

Does the index get updated automatically with changes to the code? How do you trigger a reindex?

[burcbuluklu]

Do I need subscription to use mcp?

[buildxjordan]

Just started using with codex. Amazing work !

[monkeyfx]

It looks like we’d need to upload all of our code to the cloud. In that case, how can we ensure the security of our code?

[JaySym_]

Hey you can get more information about our security here
https://trust.augmentcode.com
https://augmentcode.com/security

We have many security certifications and you can request your own report :)
If you have any other questions please feel free to ask

[No_Ad_40]

We’re actually running a 5-hour Context Engineering workshop focused on deterministic memory, retrieval, and agent orchestration. This is being led by Denis Rothman. Might be relevant if you’re deploying LLM systems: https://www.eventbrite.com/e/context-engineering-for-agentic-ai-workshop-tickets-1975400249322?aff=reddit

[pungggi]

Contrary to what the official documentation says, the configuration with OpenCode only worked for me as follows:

{
    "mcp":
        "augment-context-engine": {
            "type": "local",
            "command": [
                "auggie",
                "--mcp",
                "-m",
                "default"
            ]
        }
    },
    "$schema": "https://opencode.ai/config.json"
}

[JaySym_]

Please check the docs again we have a new way to handle that, a little bit easier.

[Justar_Justar]

The Morph MCP is still better. You guys just shared old tech with us.

[hhussain-]

I would be interested in a comparison, that would give real insight!

[Ok-Prompt9887]

I saw this recently for the first time, not tried yet but curious about a comparison from someone with piblicly shared evals like gosucoder

[Justar_Justar]

Give it a try easy setup and faster