KEIRO MCP Server
Provides direct AI-powered answers with citations via the KEIRO API.
Click on "Install 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., "@KEIRO MCP ServerSearch for the latest AI news"
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.
What is this?
This is the official Model Context Protocol (MCP) server for the KEIRO API. It enables AI assistants like Claude to search the web, conduct deep research, extract web content, and get AI-powered answers—all in real-time.
Related MCP server: Tavily MCP Server
Installation
# Clone the repository
git clone https://github.com/keiro-labs/keiro-mcp.git
cd keiro-mcp
# Install dependencies
npm install
# Build
npm run buildConfiguration
1. Get your API Key
Sign up at keiro.dev and get your API key from the dashboard.
2. Configure Claude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"keiro": {
"command": "node",
"args": ["/absolute/path/to/keiro-mcp/dist/index.js"],
"env": {
"KEIRO_API_KEY": "your_api_key_here"
}
}
}
}3. Restart Claude Desktop
The KEIRO tools will now be available in Claude.
Tools
Tool | Description |
| Fast web search with AI-optimized results |
| Enhanced search with metadata and related queries |
| Deep research with summary and key points |
| Comprehensive research with analysis and sources |
| Direct AI-powered answers with citations |
| Extract content from any web page |
Examples
Once configured, you can ask Claude things like:
"Search for the latest developments in quantum computing"
"Research the impact of AI on healthcare in 2024"
"What are the key features of the new iPhone?"
"Extract the main content from https://example.com/article"
Claude will use the appropriate KEIRO tool to fetch real-time information.
Environment Variables
Variable | Required | Description |
| Yes | Your KEIRO API key |
| No | Custom API URL (default: production) |
Development
# Watch mode
npm run dev
# Type check
npm run typecheck
# Build
npm run buildAPI Reference
This MCP server uses the following KEIRO API endpoints:
POST /search- Basic searchPOST /search-pro- Advanced searchPOST /research- Topic researchPOST /research-pro- Deep researchPOST /answer- AI answersPOST /web-crawler- Page extraction
Full API documentation: keiro.dev/docs
License
MIT © KEIRO
Available Tools
6 toolskeiro_answerA
Get a direct, AI-powered answer to any question with inline source citations. Best for factual questions requiring authoritative responses.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The question to answer |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden. It discloses that the tool is AI-powered and returns citations, which are key behaviors. It doesn't explicitly state read-only safety, but that's implied by 'answer' and not critical for a Q&A tool.
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 a single, front-loaded sentence that conveys purpose, key features, and usage context without any fluff. Every word earns its place.
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?
For a simple one-parameter tool with no output schema, the description fully covers what the tool does, what it returns (answer with citations), and when to use it. No significant gaps.
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% with one parameter 'query' described as 'The question to answer'. The description's 'any question' adds a slight hint of open-endedness but doesn't add meaningful semantics beyond the schema.
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 states a specific verb ('Get') and resource ('answer to any question'), clearly distinguishing it from sibling tools like search, research, and crawl. It also mentions key differentiators (AI-powered, inline source citations) and best-use case (factual questions).
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 gives clear guidance on when to use: 'Best for factual questions requiring authoritative responses.' It implies alternatives for non-factual or broader tasks, though it doesn't explicitly name them.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
keiro_crawlA
Extract and parse content from any web page. Returns clean, structured text optimized for AI processing. Handles JavaScript-rendered pages.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL to crawl and extract content from |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the transparency burden. It discloses that the tool 'Handles JavaScript-rendered pages' and 'Returns clean, structured text,' providing useful behavioral insight. Yet it omits details such as rate limits, authentication requirements, or behavior on non-HTML content, leaving transparency incomplete.
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 three tightly written sentences, each adding essential information: the core function, the output nature, and a key capability. It is front-loaded and contains no filler.
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?
For a simple single-parameter tool, the description covers the core purpose, return format, and JavaScript handling. The lack of an output schema is offset by the clear statement of 'clean, structured text.' Minor gaps remain regarding failure modes or limitations, but the description is sufficiently complete for typical crawling use.
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?
The schema already fully describes the only parameter (url) with 100% coverage. The description adds no new parameter-specific meaning beyond the generic 'any web page,' so it meets the baseline but does not exceed it.
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 a specific action and resource: 'Extract and parse content from any web page.' This distinguishes it from sibling tools like keiro_search and keiro_research, which likely handle broader search or research tasks. Mention of JavaScript rendering further clarifies its unique capability.
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 implies usage: use when you need to extract content from a specific web page. However, it does not explicitly state when not to use it or mention alternatives from the sibling set, so the guidance is limited to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
keiro_researchA
Conduct comprehensive research on any topic. Returns a detailed summary, key points, timeline, and cited sources. Perfect for in-depth analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The research topic or question |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It does disclose the return structure (summary, key points, timeline, cited sources), which is useful. However, it does not reveal potential limitations such as runtime, data source reliability, or any side effects, leaving the tool's operational behavior less transparent than it could be.
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 two concise sentences that are front-loaded with the core purpose, followed by the return value and a use case. Every sentence contributes meaningful information without waste or redundancy.
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?
For a tool with a single parameter and no output schema, the description covers the essential information: what it does and what it returns. It lacks explicit comparison to sibling tools or any caveats about usage, but is largely complete for a tool of this simplicity.
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?
The input schema already provides a description for the only parameter ('The research topic or question'), achieving 100% coverage. The description adds minimal extra meaning beyond that, only broadening it with 'any topic'. This does not significantly enhance the parameter semantics beyond the schema baseline.
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 primary function ('Conduct comprehensive research on any topic') and specifies the return components ('detailed summary, key points, timeline, and cited sources'). It differentiates from search-like siblings by emphasizing 'comprehensive research' and 'in-depth analysis', but does not explicitly distinguish it from the similarly named keiro_research_pro.
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 implies usage context with 'Perfect for in-depth analysis', but provides no explicit guidance on when to use this tool versus alternatives like keiro_search, keiro_search_pro, or keiro_research_pro. It lacks exclusions or when-not-to-use information.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
keiro_research_proA
Advanced research with detailed analysis, multiple perspectives, data visualizations, and comprehensive source evaluation. For complex research tasks.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The research topic or question |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It discloses the tool's output behavior (detailed analysis, multiple perspectives, data visualizations, source evaluation) but does not mention side effects, limitations, or any safety traits. This is partial but reasonable for a research tool.
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 two sentences with no filler. It front-loads the key capabilities and closes with a clear usage context, making it efficient and well-structured.
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?
For a single-parameter research tool, the description provides a solid understanding of expected outputs and target scenario. It could further differentiate from sibling tools like 'keiro_search_pro,' but the 'complex research tasks' context and feature set make it adequately complete.
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?
The schema already provides a full description for the single 'query' parameter ('The research topic or question'), achieving 100% coverage. The tool description adds no additional parameter semantic detail, so the baseline score of 3 applies.
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 indicates the tool performs research with detailed analysis, multiple perspectives, data visualizations, and source evaluation. It distinguishes itself from the simpler 'keiro_research' via 'Advanced' and 'For complex research tasks,' though the verb is implicit rather than explicit.
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 phrase 'For complex research tasks' provides clear context on when to use this tool. It does not explicitly mention when not to use it or name alternatives, but the guidance is sufficient for general targeting.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
keiro_searchB
Search the web using KEIRO's semantic search engine. Returns relevant results with titles, URLs, and content snippets optimized for AI consumption.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses that the tool returns 'titles, URLs, and content snippets' and that results are optimized for AI, which is useful. However, it does not mention whether the operation is read-only, if any rate limits apply, or how query complexity might affect results. The absence of any caveats or behavioral constraints keeps this at a 3.
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 a single, focused sentence that conveys the core purpose and output without any filler. It is appropriately sized for a simple one-parameter tool.
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?
Given the tool's simplicity (one parameter, no output schema), the description adequately covers the main purpose and return format. It gets a 4 because it loses one point for not clarifying how this is distinct from sibling tools, which is relevant context for an agent choosing between them.
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 the single parameter 'query' is already documented as 'The search query.' The description adds no new meaning beyond that, but the baseline of 3 applies because the schema fully covers the parameter semantics.
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 action: 'Search the web using KEIRO's semantic search engine.' It specifies the resource (web) and the method (semantic search), and mentions the output (titles, URLs, snippets). However, it does not explicitly differentiate from sibling tools like keiro_search_pro or keiro_research, so it earns a 4 rather than 5.
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?
No guidance is provided about when to use this tool versus the more specialized siblings (pro, research, answer, crawl). The only implied usage is that results are 'optimized for AI consumption,' but there is no explicit statement of preferred scenarios, limitations, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
keiro_search_proA
Advanced search with enhanced results, metadata, related queries, and deeper content extraction. Best for comprehensive information gathering.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses the tool returns enhanced results, metadata, related queries, and deeper content extraction, which gives a sense of behavior. However, it does not clarify what 'deeper content extraction' entails, whether results are structured, or any operational characteristics like speed or rate limits.
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 two sentences long, front-loaded with the core purpose ('Advanced search') and followed by concrete feature bullets. Every clause adds value: the first sentence enumerates capabilities, the second states the ideal use case. No redundancy or filler.
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?
For a simple one-parameter tool with no output schema, the description is fairly complete. It explains the tool's purpose, capabilities (including what kinds of data it returns), and when to use it. It does not detail output structure, but that may be acceptable given the simplicity and the partial behavioral disclosure.
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?
The schema has 100% description coverage for the 'query' parameter with a simple description. The tool description adds context that the search is advanced and comprehensive but gives no additional specifics about the query parameter beyond what the schema already states. This aligns with the baseline 3 for high schema coverage.
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 identifies this as an advanced search tool with a specific verb ('search') and resource (comprehensive information gathering). It lists distinguishing capabilities (enhanced results, metadata, related queries, deeper content extraction) that set it apart from basic search, though it does not explicitly name sibling tools.
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 phrase 'Best for comprehensive information gathering' provides clear context for when to use this tool, implying a preference for in-depth research over quick lookups. However, it lacks explicit exclusions or references to alternatives like keiro_answer or keiro_search, so it does not fully meet the 5-level benchmark.
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. Dates show when Glama detected each change.
6 tool updates
v1.0.0- First observed
keiro_answer - First observed
keiro_crawl - First observed
keiro_research - First observed
keiro_research_pro - First observed
keiro_search - First observed
keiro_search_pro
TDQS
Multiple tools serve search and research purposes, with base and pro variants that overlap in functionality. The descriptions clarify output differences (e.g., search returns links, research returns summaries), reducing confusion, but an agent may still hesitate between search and research for a given task.
All tools follow the keiro_ prefix and use a consistent pattern of action terms (search, research, answer, crawl) with a uniform _pro suffix for advanced variants. Naming is highly predictable and easy to navigate.
Six tools is well within the ideal 3-15 range. The set covers basic and advanced search, basic and advanced research, direct answering, and crawling, which is well-scoped for a web intelligence server without unnecessary redundancy.
The tool surface covers the main stages of online information gathering: searching, deep research, direct Q&A, and page extraction. Minor gaps exist, such as lacking a tool for iterating through paginated search results, but these can be worked around with existing capabilities.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.
Agent-native search engine with live web research optimized for AI agents.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Web search and page-reading for AI agents. One-click OAuth connect, or a Caesar API key.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to perform real-time web searches, company research, content crawling, LinkedIn searches, and deep research using the Exa AI Search API. Provides comprehensive web information retrieval capabilities in a safe and controlled manner.225,4621MIT
- AlicenseBqualityDmaintenanceProvides AI assistants with real-time web search capabilities and intelligent data extraction from web pages through Tavily's advanced search API.220,899MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to access real-time web data through search, markdown scraping, and browser automation while bypassing anti-bot protections. It provides tools for web research, e-commerce monitoring, and data extraction from across the globe.48,7545MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform real-time web searches, deep research, content extraction, and AI-powered answers via the KEIRO API.MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Neptaverse/Keiro-MCP-TS'
If you have feedback or need assistance with the MCP directory API, please join our Discord server