Back to the catalog

io.github.Cranot/agentskb

Researched knowledge for AI agents. Canonical answers from official sources.

Open source Open in the app JSON README (API)

About

Researched knowledge for AI agents. Canonical answers from official sources.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
cranot
Origin
official
Category
ferramentas
Transport
local
Version
0.1.1
Stars
9
Forks
3
Last push
2026-07-27T17:15:55Z
Repository state
ativo
Added
2026-08-29 03:01:48
Updated
2026-08-29 03:01:48
Origin id
io.github.Cranot/agentskb

README

# AgentsKB MCP Server

**Give Your AI Expert-Level Knowledge**

Researched answers to any problem. Your AI, upgraded.

> **About this repository:** AgentsKB is a **hosted** MCP server — there is no server
> to build or run locally, and this repository contains no source code. It exists to
> document the endpoint and to collect bug reports. Point your MCP client at the URL
> below and you are done.

## Installation

The server is hosted at `https://mcp.agentskb.com/mcp-kb` and speaks MCP over
streamable HTTP. **No API key and no signup are required.**

### Claude Code

```bash
claude mcp add --transport http agentskb https://mcp.agentskb.com/mcp-kb
```

Add `--scope user` to make it available in every project instead of just the
current one. Verify the connection with:

```bash
claude mcp list
```

### Claude Desktop, Cursor, Cline, and other MCP clients

Add this to your client's MCP configuration file:

```json
{
  "mcpServers": {
    "agentskb": {
      "type": "http",
      "url": "https://mcp.agentskb.com/mcp-kb"
    }
  }
}
```

Config file locations:

| Client | File |
|--------|------|
| Claude Code (per-project) | `.mcp.json` in the project root |
| Claude Code (global) | `~/.claude.json` |
| Claude Desktop | `claude_desktop_config.json` |
| Cursor (global) | `~/.cursor/mcp.json` |
| Cursor (per-project) | `.cursor/mcp.json` in the project root |

Cursor does not use the `type` field — for Cursor, list `url` on its own.

Some older clients do not support remote HTTP servers and only launch local
processes. If yours is one of them, bridge to the endpoint with
[`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

```json
{
  "mcpServers": {
    "agentskb": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.agentskb.com/mcp-kb"]
    }
  }
}
```

### REST API (no MCP client)

The knowledge base is also reachable over plain HTTP, with no key:

```bash
curl -X POST https://agentskb-api.agentskb.com/api/free/ask \
  -H "Content-Type: application/json" \
  -d '{"question":"What is a PostgreSQL index scan?"}'
```

## What makes us different

Your AI searches. We research. That's the difference.

- **Dedicated research per question** - not a side task while debugging
- **Official sources only** - docs, specs, RFCs
- **Would rather not answer than guess wrong**

## Tools

| Tool | Arguments | Description |
|------|-----------|-------------|
| `ask_question` | `question`\*, `domain`, `limit` | Expert-quality answers with sources |
| `preflight_check` | `task`\*, `depth` | See what verified knowledge exists for your task |
| `search_questions` | `query`\*, `domain`, `limit` | Browse Q&As by topic |
| `get_stats` | — | Coverage metrics |
| `consult_taxonomy` | `path`, `depth` | Navigate the knowledge taxonomy |
| `check_prerequisites` | `domain`\* | Foundational topics to understand first |
| `get_lockfile_status` | — | Check whether strict/pinned-answer mode is active |

\* required. `question` and `query` expect a full natural-language question —
bare keywords such as `mysql` are rejected.

The server also exposes two resources: `agentskb://context/current` (detected
project stack) and `agentskb://context/prompt` (a system-prompt fragment for
that stack).

## Coverage

55,000+ Q&As across 287 domains. The deepest coverage today is:

- **Databases and ORMs:** PostgreSQL, Prisma, Drizzle
- **Frameworks:** Next.js, NextAuth, Vue
- **Infrastructure and tooling:** Docker, Bash, nginx, Git

Call `get_stats` for live counts, or `consult_taxonomy` to browse the full
domain list.

Coverage is uneven and still growing. If you ask about a topic that is not yet
covered, the server queues it for research and replies
`Topic '<name>' research queued` instead of returning an answer — ask again
later.

## Reporting bugs

Open an issue on this repository:
<https://github.com/Cranot/agentskb-mcp/issues>

## Related

- Website: <https://agentskb.com>
- `@agentskb/cli` on npm: <https://www.npmjs.com/package/@agentskb/cli> — a
  **separate** tool for pinning and verifying answers in a repo (`init`,
  `check`, `lock`, `request`, `update`, `verify`). It does not implement an MCP
  server and is not needed to use the endpoint above.

## License

MIT

More