# aimnis

aimnis — a hosted MCP server for web search. It answers from a shared cache when it can, goes live when it cannot, and tags each result with its source.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 289 installs
- Author: john-hoqm
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/john-hoqm/aimnis
- Updated: 2026-07-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/aimnis

## What it does

aimnis is a remote MCP server reached over HTTP, and it hands the agent two tools. `search` looks in a pool shared by everyone using the server: if your question, or one close enough in meaning, has come up before, the tagged answer returns straight away. On a miss it queries the live web and files what it found back into the pool.

\`stats` reports on that pool: how large it has grown, the share of queries served from cache over all time and recently, and which queries get reused most.

The pool is shared, not yours alone. Anything your search brings in stays there for other agents, so weigh that before pointing it at sensitive lookups. There is nothing to host yourself; the endpoint is `https://aimnis--john-hoqm.run.tools`.

## Requirements
- Remote server: `https://aimnis--john-hoqm.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http aimnis https://aimnis--john-hoqm.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add aimnis --url https://aimnis--john-hoqm.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aimnis": {
            "url": "https://aimnis--john-hoqm.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aimnis": {
            "type": "http",
            "url": "https://aimnis--john-hoqm.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http aimnis https://aimnis--john-hoqm.run.tools
```

## When to use it
- get an answer with its source attached without paging through results
- skip the network round-trip on a question the pool already answers
- see which queries other agents reuse most
- check the recent cache hit rate before trusting the pool
- trace an error message to its docs in one lookup

## Example prompts
- Search the web through aimnis for the `httpx` timeout docs and cite the page
- Run aimnis stats and tell me the pool size and cache hit rate
- Look up this stack trace with aimnis before we start guessing

## Similar
- [aieph](https://affpapa.org/en/nevibecode/mcp/aieph.md) — MCP server · ★ 1 repo stars
- [deep-research](https://affpapa.org/en/nevibecode/skills/affaan-m-deep-research.md) — skill · 7000 installs
- [secant-agent-research-pack](https://affpapa.org/en/nevibecode/mcp/secant-agent-research-pack.md) — MCP server · 165 installs
- [Web Researcher MCP](https://affpapa.org/en/nevibecode/mcp/web-researcher-mcp.md) — MCP server · ★ 79 repo stars
- [LastSearch](https://affpapa.org/en/nevibecode/mcp/lastsearch.md) — MCP server · ★ 20 repo stars
- [tavily-research](https://affpapa.org/en/nevibecode/skills/tavily-research.md) — skill · 25100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
