block · angiejones · Jun 22, 2025 · Jun 22, 2025 · Jun 22, 2025
@@ -116,7 +116,7 @@ Without tool calling, LLMs would only guess answers based on their training data
 
 It's worth noting that not all agents are the same when it comes to tool access. Most proprietary agents are tightly scoped to a specific LLM and a predefined set of tools, as companies build agents tailored for their own applications.
 
-Other agents, like Goose, are more extensible, allowing users to configure it with the LLM of their choice, as well as add tools for various APIs, databases, and even [local environments like IDEs](/docs/tutorials/jetbrains-mcp). However, for agents to scale across different tools and systems without requiring custom integrations for each one, they need a standardized way to discover, call, and manage tools. This is exactly what the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) provides.
+Other agents, like Goose, are more extensible, allowing users to configure it with the LLM of their choice, as well as add tools for various APIs, databases, and even [local environments like IDEs](/docs/mcp/jetbrains-mcp). However, for agents to scale across different tools and systems without requiring custom integrations for each one, they need a standardized way to discover, call, and manage tools. This is exactly what the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) provides.
 
 ## MCP Ecosystem
 
@@ -132,9 +132,9 @@ At the time of this writing, there are more than [1000 MCP servers](https://www.
 
 For example, let's say I want Goose to develop a new web app for me in my WebStorm IDE based on a Figma design and then commit the code to a new repo in GitHub. I can add the following MCP Servers as Goose extensions to give it all of these capabilities:
 
-* [Figma](/docs/tutorials/figma-mcp)
-* [JetBrains](/docs/tutorials/jetbrains-mcp)
-* [GitHub](/docs/tutorials/github-mcp)
+* [Figma](/docs/mcp/figma-mcp)
+* [JetBrains](/docs/mcp/jetbrains-mcp)
+* [GitHub](/docs/mcp/github-mcp)
 
 With this, I can prompt my AI agent in natural language and it'll take care of the work:
 

@@ -18,7 +18,7 @@ One of the most common mistakes users make is trying to accomplish too much in a
 
 Every message adds to the context window, which is the amount of conversation history Goose can retain at any given time. This history is made up of tokens, the individual pieces of text (words or even parts of words) that Goose processes to generate responses. More tokens don’t just increase processing time, they also contribute to LLM usage costs. And once the context window fills up, older messages get pushed out, which can lead to loss of important details or unexpected behavior.
 
-Think of it like keeping too many browser tabs open. Eventually, it impacts performance. Instead, start fresh sessions for distinct tasks. Don't worry about losing context; that's exactly what the [Memory extension](/docs/tutorials/memory-mcp) is for. Keeping sessions focused and concise ensures more accurate, relevant responses while also keeping your LLM costs under control.
+Think of it like keeping too many browser tabs open. Eventually, it impacts performance. Instead, start fresh sessions for distinct tasks. Don't worry about losing context; that's exactly what the [Memory extension](/docs/mcp/memory-mcp) is for. Keeping sessions focused and concise ensures more accurate, relevant responses while also keeping your LLM costs under control.
 
 
 ## 2. Minimize Active Extensions
@@ -27,7 +27,7 @@ When it comes to Goose extensions, less is often more. It's tempting to enable [
 
 Consider this: if you're cooking in a kitchen, having every possible utensil and appliance out on the counter doesn't make you a better chef. It just creates clutter and confusion. The same principle applies here. 
 
-Go ahead and install any extensions that interest you, but [keep them disabled](/docs/getting-started/using-extensions#enablingdisabling-extensions) until you need them. Start with the built-in [Developer extension](/docs/tutorials/developer-mcp) enabled, which is surprisingly powerful on its own, and only enable others when you need their specific capabilities. This leads to faster responses, lower token usage, and often more focused solutions.
+Go ahead and install any extensions that interest you, but [keep them disabled](/docs/getting-started/using-extensions#enablingdisabling-extensions) until you need them. Start with the built-in [Developer extension](/docs/mcp/developer-mcp) enabled, which is surprisingly powerful on its own, and only enable others when you need their specific capabilities. This leads to faster responses, lower token usage, and often more focused solutions.
 
 :::tip Bonus Tip
 Before starting a complex task, ask Goose about its current capabilities. A simple prompt like "Do you have tools available to work with [specific technology/service]?" can save time and prevent false starts. Goose can tell you whether it has the necessary tools for your task, and if not, suggest which extensions you might need to enable. This quick check ensures you have the right tools ready before diving in too deep.

@@ -29,7 +29,7 @@ Throughout the stream, Adewale shared valuable tips to prepare your design for G
 # Getting Started with Goose and Figma
 Whether you're a designer wanting to rapidly turn concepts into working code or a developer curious about streamlining design implementation, you can download Goose with its built-in [Developer extension](https://block.github.io/goose/docs/getting-started/installation) and add the [Figma extension](https://block.github.io/goose/v1/extensions/). 
 
-For step-by-step instructions, check out the [Figma tutorial](https://block.github.io/goose/docs/tutorials/figma-mcp).
+For step-by-step instructions, check out the [Figma tutorial](/docs/mcp/figma-mcp).
 
 <head>
   <meta property="og:title" content="Goose Flight School: Turn Figma Designs Into Code With Goose" />

@@ -46,7 +46,7 @@ These powerful debugging and analysis capabilities are only the beginning. This
 
 To keep up with the exciting developments as they release, you can check out both of the [Goose](https://github.com/block/goose) and [Langfuse](https://github.com/langfuse/langfuse) repositories on GitHub. 
 
-You can also watch the [livestream discussing the Goose and Langfuse integration](https://www.youtube.com/live/W39BQjsTS9E?feature=shared), and follow the [tutorial showing you how to integrate Langfuse with Goose](https://block.github.io/goose/docs/tutorials/langfuse).
+You can also watch the [livestream discussing the Goose and Langfuse integration](https://www.youtube.com/live/W39BQjsTS9E?feature=shared), and follow the [tutorial showing you how to integrate Langfuse with Goose](/docs/tutorials/langfuse).
 
 Also, be sure to subscribe to our [events calendar](https://calget.com/c/t7jszrie) to catch upcoming events.
 

@@ -40,7 +40,7 @@ If you want Goose to remember your preferences, you can say,
 
 >_**Goose, remember I’m not a developer. Explain things at a high level unless I ask for technical details**_
 
-If you have the [Memory Extension](/docs/tutorials/memory-mcp) enabled, Goose will save this preference so you won’t have to remind it every time. 
+If you have the [Memory Extension](/docs/mcp/memory-mcp) enabled, Goose will save this preference so you won’t have to remind it every time. 
 :::
 
 ## Chain-of-Thought Prompting

@@ -20,7 +20,7 @@ There's so many amazing MCP servers out there to make my work life better, inclu
 I used GPT-4o for this task
 :::
 
-With this prompt, Goose reviews my uncompleted tasks in Asana (note that I have my workspace, project, and user IDs stored in [memory](/docs/tutorials/memory-mcp)).
+With this prompt, Goose reviews my uncompleted tasks in Asana (note that I have my workspace, project, and user IDs stored in [memory](/docs/mcp/memory-mcp)).
 
 Rather than bouncing between different types of work, which is a productivity killer, Goose sorts my tasks into categories based on context. For example:
 

@@ -53,7 +53,7 @@ The features don't end here. The team is actively exploring several exciting fea
 # Community and Contributing
 The project is open source, and welcomes contributions from the community. If you'd like to support the project or directly contribute to it, you can check out [the VSCode MCP repo on GitHub](https://github.com/block/vscode-mcp), or [join the Block Open Source Discord](https://discord.gg/block-opensource) if you'd like to ask the team any questions or start discussions.
 
-You can also follow the [tutorial showing you how to integrate VS Code with Goose](https://block.github.io/goose/docs/tutorials/vscode-mcp).
+You can also follow the [tutorial showing you how to integrate VS Code with Goose](/docs/mcp/vscode-mcp).
 
 <head>
   <meta property="og:title" content="Cracking the Code in VS Code" />

@@ -7,7 +7,7 @@ authors:
 
 ![blog cover](vibe-coding.png)
 
-Imagine creating an app just by describing what you want out loud, like you’re talking to a friend. That’s the magic of vibe coding: turning natural language into working code with the help of an AI agent. And while typing a prompt gets the job done, saying it out loud hits different 🔥 The new [Speech MCP server](https://block.github.io/goose/docs/tutorials/speech-mcp) has quite literally entered the chat.
+Imagine creating an app just by describing what you want out loud, like you’re talking to a friend. That’s the magic of vibe coding: turning natural language into working code with the help of an AI agent. And while typing a prompt gets the job done, saying it out loud hits different 🔥 The new [Speech MCP server](/docs/mcp/speech-mcp) has quite literally entered the chat.
 
 <!--truncate-->
 

@@ -24,18 +24,18 @@ That's exactly where MCP comes in. Best part is, you don't need to be a develope
 ## MCP Servers You Should Try Right Now
 So what can you connect your AI agent to? MCP Servers! MCP servers give your agent access to your tools. With [over 3000 MCP servers](https://glama.ai/mcp/servers) you can connect to, here is your top list of popular MCP servers you should try:
 
-- **[Google Drive](/docs/tutorials/google-drive-mcp)**: File access and search capabilities for Google Drive
-- **[YouTube Transcript](/docs/tutorials/youtube-transcript)**: Grab and work with YouTube video transcripts
-- **[Google Maps](/docs/tutorials/google-maps-mcp)**: Location services, directions, and place details
-- **[Tavily Web Search](/docs/tutorials/tavily-mcp)**: Web and local search using Tavily's Search API
-- **[Asana](/docs/tutorials/asana-mcp)**: View asana tasks, projects, workspaces, and/or comments
-- **[Speech](/docs/tutorials/speech-mcp)**: Real-time voice interaction, audio/video transcription, text-to-speech conversion and more
-- **[GitHub](/docs/tutorials/github-mcp)**: Tools to read, search, and manage Git repositories
-- **[Fetch](/docs/tutorials/fetch-mcp)**: Web content fetching and conversion for efficient LLM usage
+- **[Google Drive](/docs/mcp/google-drive-mcp)**: File access and search capabilities for Google Drive
+- **[YouTube Transcript](/docs/mcp/youtube-transcript-mcp)**: Grab and work with YouTube video transcripts
+- **[Google Maps](/docs/mcp/google-maps-mcp)**: Location services, directions, and place details
+- **[Tavily Web Search](/docs/mcp/tavily-mcp)**: Web and local search using Tavily's Search API
+- **[Asana](/docs/mcp/asana-mcp)**: View asana tasks, projects, workspaces, and/or comments
+- **[Speech](/docs/mcp/speech-mcp)**: Real-time voice interaction, audio/video transcription, text-to-speech conversion and more
+- **[GitHub](/docs/mcp/github-mcp)**: Tools to read, search, and manage Git repositories
+- **[Fetch](/docs/mcp/fetch-mcp)**: Web content fetching and conversion for efficient LLM usage
 
 This quick list should give you an idea of all the ways you can now use AI agents with your workflow. You can also explore community favorites in [handy MCP directories](https://dev.to/techgirl1908/my-favorite-mcp-directories-573n), and learn [how to check MCP servers are safe](/blog/2025/03/26/mcp-security) before installing.
 
-You can also check out these [Goose tutorials](/docs/category/tutorials), showing you exactly how you can use some of these popular MCP servers with Goose, or use [Goose's Tutorial extension](/docs/tutorials/tutorial-extension) to get extra help walking you through using or building extensions.
+You can also check out these [Goose tutorials](/docs/category/mcp-servers), showing you exactly how you can use some of these popular MCP servers with Goose, or use [Goose's Tutorial extension](/docs/mcp/tutorial-mcp) to get extra help walking you through using or building extensions.
 
 ## Example MCP Prompts
 Now that you've caught a glimpse of some of the MCP servers that out there, how do you make sure you're using MCPs with AI agents the best you can? This is where prompts come in.

@@ -22,7 +22,7 @@ You can ask Goose what you can do with an extension to get a list of all the fea
 
 ## GitHub MCP Server: Everything GitHub
 
-The [GitHub MCP Server](/docs/tutorials/github-mcp) comes with quite a lot of functionality. It can help you create issues, pull requests, repositories, and branches. My most frequent use case for the GitHub MCP is reviewing and understanding pull requests.
+The [GitHub MCP Server](/docs/mcp/github-mcp) comes with quite a lot of functionality. It can help you create issues, pull requests, repositories, and branches. My most frequent use case for the GitHub MCP is reviewing and understanding pull requests.
 
 For cases when it's a large pull request, or I don't understand what is going on, I can pass the PR to Goose, giving it the right context to make me understand and then act on the pull request. I'm even able to create a documentation update or changelog update from the file changes in the PR. This is definitely one of my favorite things. 
 
@@ -34,7 +34,7 @@ Hey Goose, this pull request https://github.com/block/goose/pull/1949, has a lot
 
 ## Knowledge Graph Memory: Context on Steroids
 
-The [Knowledge Graph Memory](/docs/tutorials/knowledge-graph-mcp) extension is like giving Goose a photographic memory of your project or data. Like the name implies, it creates a graph of any information fed into it, connecting the dots between different pieces of information or as I like to use it for - documentation. 
+The [Knowledge Graph Memory](/docs/mcp/knowledge-graph-mcp) extension is like giving Goose a photographic memory of your project or data. Like the name implies, it creates a graph of any information fed into it, connecting the dots between different pieces of information or as I like to use it for - documentation. 
 
 If I'm working on a specific project or library and I don't want any hallucinations, I am able to feed Goose with the right context and it will be able to answer questions about the project or library with the right context.
 
@@ -48,22 +48,22 @@ I'm currently in a project called Goose, read through the documentation in `docu
 
 ## Fetch Extension: The Web in our Hands
 
-I had a slightly hard time deciding between the [Tavily Web Search Extension](/docs/tutorials/tavily-mcp) and The [Fetch Extension](/docs/tutorials/fetch-mcp) because while I do use them both to access the web, the Fetch extension works more like default for me. With the example above using the Knowledge graph, I'm able to get information from the internet to give Goose additional context to work with. 
+I had a slightly hard time deciding between the [Tavily Web Search Extension](/docs/mcp/tavily-mcp) and The [Fetch Extension](/docs/mcp/fetch-mcp) because while I do use them both to access the web, the Fetch extension works more like default for me. With the example above using the Knowledge graph, I'm able to get information from the internet to give Goose additional context to work with. 
 
 :::note
 The Tavily Web Search Extension has deep research capabilities and is great for finding specific information, while the Fetch Extension is more about general web access and data retrieval.
 :::
 
 ## Memory Extension: My Habits and Preferences
 
-I use the [Memory Extension](/docs/tutorials/memory-mcp) to remind Goose about my general preferences as I work - to default to JavaScript or Node when trying out new prototypes, if I prefer one naming convention or the other - maybe even how I like my coffee :D.
+I use the [Memory Extension](/docs/mcp/memory-mcp) to remind Goose about my general preferences as I work - to default to JavaScript or Node when trying out new prototypes, if I prefer one naming convention or the other - maybe even how I like my coffee :D.
 
 This works differently from the Knowledge Graph extension even though they both store information locally. When combined with the Knowledge Graph, it can also help maintain a clear trail of technical decisions and their rationale. For example I got stuck on a code migration and asked Goose to remember where we stopped, what we've tried so far, and what we want to do next for when I start a new session.
 
 
 ## VS Code Extension: Your Favorite Editor, Connected
 
-One of the biggest points in conversations with people especially around vibe coding, is finding ways to track what changes are being made. While version control is always recommended, sometimes I want to be able to stop or change direction before going too far. The [VS Code Extension](/docs/tutorials/vscode-mcp) alongside other features, allows me to preview the diff of my code changes before I commit them. 
+One of the biggest points in conversations with people especially around vibe coding, is finding ways to track what changes are being made. While version control is always recommended, sometimes I want to be able to stop or change direction before going too far. The [VS Code Extension](/docs/mcp/vscode-mcp) alongside other features, allows me to preview the diff of my code changes before I commit them. 
 
 I can choose to accept or refuse these changes, or tell Goose to try something else before any actual changes are made.
 

@@ -108,7 +108,7 @@ Here are a few examples:
 
 ### 7. Integrate Goose into Your CI/CD
 
-Before issues hit production, add [Goose to your CI/CD pipeline](https://block.github.io/goose/docs/tutorials/cicd) to:
+Before issues hit production, add [Goose to your CI/CD pipeline](/docs/tutorials/cicd) to:
 - Automate code reviews  
 - Validate documentation  
 - Run security checks  
@@ -119,7 +119,7 @@ Some MCP servers can introduce security risks, especially if compromised.
 
 Use the Goose [allowlist](https://github.com/block/goose/blob/main/crates/goose-server/ALLOWLIST.md) feature to prevent Goose from calling unsafe or untrusted tools.
 
-Here's how the team at Block is thinking about [securing the MCP](https://block.github.io/goose/blog/2025/03/31/securing-mcp).
+Here's how the team at Block is thinking about [securing the MCP](/blog/2025/03/31/securing-mcp).
 
 ### 9. Pick a High-Performing LLM