TABLE OF CONTENTS
Overview
The Stack Internal MCP server helps your MCP-compatible assistant search and retrieve indexed Stack Internal knowledge. To learn more about the Stack Internal MCP server, read the MCP Server Quickstart and MCP Server Overview articles.
The Stack Internal MCP server currently provides two read-only tools: search_nodes and get_node. Use the examples in this guide to apply these tools to find, review, summarize, and verify existing knowledge.
MCP tools
Ask questions in your client's chat box. Your assistant can use the available tools when its tool-use settings allow it.
search_nodes Searches indexed Node Extractor nodes. It accepts a query, up to 100 results, and, when supported by your client, lexical_v1 or semantic_v1 search.
get_node Retrieves a node by ID. Use the node ID from a search result when you need the full available text and metadata.
Agent instructions
If your client supports agent instructions, you can tell it to search before relying on general guidance. For example, add "Search first, then cite the most relevant source" to relevant instructions or prompts.
Use cases
Below are just a few examples of how you can apply the MCP server in your own workflows.
Ground code in internal standards
Ask your assistant about a standard or convention. It can search for relevant nodes, then return links and details that are available in the indexed source.
- "What’s our standard approach to error handling in backend services?"
- "How should I structure logging in this service?"
- "I need to add a new database migration. What’s our process?"
Accelerate onboarding
New hires can ask practical onboarding questions and use Stack Internal sources to understand their team's established ways of working.
- "How do I run the full test suite locally?"
- "What’s our branching strategy?"
- "How is authentication handled in our platform? I’m coming from a team that used OAuth differently."
Handle sensitive code carefully
For security, compliance, and regulated work, use the MCP server to find your organization's existing guidance. Then open the most relevant result and verify important decisions against the linked source before you act.
- "How do we handle PII in our logging pipeline?"
- "Search for our approved encryption patterns and summarize the relevant guidance."
- "If your team has deprecated a pattern, ask for it by name. The search can surface the relevant indexed notice or guidance when it's available."
Refresh stale content
Use the MCP server to search for content that references tools, libraries, or patterns your team has moved away from. Review the returned source links and node content, then update the original source through its normal workflow.
- "Search for anything referencing Jenkins, as we’ve migrated to GitHub Actions. List the most relevant results and their source links."
- "Search for our Kubernetes deployment process. Open the most relevant node and tell me whether it mentions the current deploy flow."
- "Search for rate-limiting guidance for internal APIs. If you can't find an answer, identify the closest related sources I should review."
Work effectively
Start broad, then narrow your request. For example, search for "incident response", open the most relevant result, and ask for a summary with the source link.
Search results can include a node ID, title, source, source ID, score, content ID, and source URL when those fields are available. A retrieved node can include text and available metadata such as dates, author, trust information, relations, and classification signals.