Agentset
OfficialThe Agentset MCP server enables intelligent, document-based applications using Retrieval-Augmented Generation (RAG). With this server, you can:
Look up information in a knowledge base for various use cases
Find relevant documents or information on specific topics
Access company policies, procedures, and guidelines
Retrieve product specifications and technical documentation
Get contextual information to answer company-specific questions
Find historical data about projects
Customize search parameters (adjust the number of results with topK and enable/disable reranking for relevance)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Agentsetupload my project documentation and ask what the API authentication flow is"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Agentset MCP
MCP server for Agentset, an open-source platform for Retrieval-Augmented Generation (RAG). Designed for developers who want to build intelligent, document-based applications quickly and efficiently.
Installation
using npm:
AGENTSET_API_KEY=your-api-key npx @agentset/mcp --ns your-namespace-idusing yarn:
AGENTSET_API_KEY=your-api-key yarn dlx @agentset/mcp --ns your-namespace-idusing pnpm:
AGENTSET_API_KEY=your-api-key pnpm dlx @agentset/mcp --ns your-namespace-idRelated MCP server: MCP-RAGNAR
Adding to Claude
{
"mcpServers": {
"agentset": {
"command": "npx",
"args": ["-y", "@agentset/mcp@latest"],
"env": {
"AGENTSET_API_KEY": "agentset_xxx",
"AGENTSET_NAMESPACE_ID": "ns_xxx"
}
}
}
}Tips
Passing namespace id as an environment variable
AGENTSET_API_KEY=your-api-key AGENTSET_NAMESPACE_ID=your-namespace-id npx @agentset/mcpPassing a custom tool description
AGENTSET_API_KEY=your-api-key npx @agentset/mcp --ns your-namespace-id -d "Your custom tool description"Passing a tenant id:
AGENTSET_API_KEY=your-api-key npx @agentset/mcp --ns your-namespace-id -t your-tenant-idAPI Reference
Visit the full documentation for more details.
Available Tools
1 toolknowledge-base-retrieveA
Look up information in the Knowledge Base. Use this tool when you need to:
Find relevant documents or information on specific topics
Retrieve company policies, procedures, or guidelines
Access product specifications or technical documentation
Get contextual information to answer company-specific questions
Find historical data or information about projects
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The query to search for data in the Knowledge Base | |
| topK | No | The maximum number of results to return. Defaults to 10. | |
| rerank | No | Whether to rerank the results based on relevance. Defaults to true. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description fully carries the burden of disclosing behavior. It only describes basic functionality without addressing side effects (none expected but not stated), read-only nature, error handling, or performance characteristics. For a retrieval tool, the description should at least imply idempotency or lack of mutations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and efficiently uses a bulleted list for clarity. The opening sentence is slightly generic, but overall it is well-structured and not verbose. Every line adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers common use cases but lacks information about the return format (no output schema) and potential errors. For a simple retrieval tool, it is partially complete, but missing output schema details and edge case handling reduces completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds no additional detail beyond the schema's parameter descriptions. It does not explain the implications of rerank or topK further, nor does it provide usage examples for parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Look up information in the Knowledge Base.' It provides a specific verb ('retrieve') and resource ('Knowledge Base'), and lists concrete use cases like finding documents, policies, and product specs. Since there are no sibling tools, no differentiation is needed.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly instructs when to use the tool via a bulleted list of scenarios (e.g., 'Find relevant documents,' 'Access product specifications'). It provides clear context but does not mention when not to use it or alternatives, which is less critical given no sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- First observed
knowledge-base-retrieve
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of confusion or overlap. The tool's purpose is clearly defined as knowledge base retrieval, making selection unambiguous.
With a single tool named knowledge-base-retrieve, there is no inconsistent naming pattern. The name is descriptive and predictable, though hyphenated rather than snake_case or camelCase.
One tool is borderline: it is sufficient for a simple read-only knowledge base retrieval service, but the 'Agentset' server name suggests a broader scope that is not reflected by a single tool.
The tool covers retrieval well, but there are no create, update, delete, or list operations. For a purely read-only knowledge base this may be sufficient, but for a general knowledge base or an agent set, the surface is incomplete.
Maintenance
Related MCP Connectors
Ingest, manage, and retrieve documents for RAG-powered AI applications
Your private knowledge base: upload documents (.md, .txt, .docx, PDF, images), the platform indexes
- KumbukaOAuthai.kumbuka
Governed, auditable knowledge your team curates for its AI assistants, self-hostable
Cloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceRAG-powered document search server that enables semantic search across large collections of legal and business documents (PDF, Word, Excel, PowerPoint) using local embeddings with no API costs.4MIT
- AlicenseNot gradedqualityDmaintenanceA local RAG server that enables document indexing and sentence window retrieval across multiple file formats like PDF, MD, and DOCX. It supports both local Hugging Face models and OpenAI embeddings for efficient context-aware querying through the Model Context Protocol.GPL 3.0
- FlicenseNot gradedqualityDmaintenanceA fully offline local RAG server that utilizes ChromaDB and Ollama to index and query PDF, text, and Markdown documents. It allows users to manage local knowledge bases and perform semantic searches with AI-generated responses.-
- FlicenseAqualityDmaintenanceEnables indexing local documents (PDF, Markdown, text, code) into a knowledge base and querying them via semantic search using local embeddings, all running privately on your machine.4-