Skip to main content
Glama
README.md
# agentdocs

agentdocs answers questions about the IMBA agent platform
from its published documentation: the canonical agent
facts, the use-case playbook, the tier policy, where each
MCP belongs in catalogs, the list of public doc URLs, and
the contents of individual allowlisted public doc URLs.

It is a forwarding client, not a wallet. The documented
product behind the docs is a prepaid-card / crypto agent
wallet, but this package exposes documentation retrieval
only — the same six read-only tools the original docs
server exposes — and no operational, registration,
deposit, purchase or withdrawal capability of any kind.
Every captured tool description repeats that the surface
moves no money. `get_public_url` is forwarded like the
others; its allowlist is enforced upstream.

## Tools

- `get_agent_facts` — canonical prepaid-agent policy and
  catalog: Visa prepaid, eSIM, gift cards, KYT address
  screen, USDT TRC-20, forbidden rails, tiers. No
  arguments.
- `get_agent_use_cases` — the playbook for what agents
  can buy, with the MCP tools per job. No arguments.
- `get_tier_policy` — Tier 0 vs 1+: convert and withdraw
  policy. No arguments.
- `get_catalog_placement` — which directories take the
  docs MCP vs the spend MCP. No arguments.
- `get_public_url` — fetch one allowlisted public docs
  URL. Required: `url` (an absolute
  `https://imbawallet.com` URL from the allowlist).
- `list_docs_urls` — list the public agent URLs: HowTo,
  use cases, tiers, discovery, OpenAPI, MCP endpoints.
  No arguments.

tools/list is served locally from the tool literals
captured verbatim from the published remote. A tools/call
is forwarded upstream and the result — content,
structuredContent and any `isError` flag — comes back
verbatim, so an upstream refusal (for example a
`get_public_url` allowlist error) passes through
unchanged.

## Configuration

- `IMBA_DOCS_MCP_URL` (optional, labelled
  reconstruction) — override the docs endpoint. Defaults
  to `https://imbawallet.com/mcp/docs`.

Failures surface as this rebuild's own error text
(labelled reconstruction): `agentdocs error: ...` — a
JSON-RPC error carries the upstream message, an HTTP
failure carries the status, and an unparseable response
is reported as a malformed response.

### Forwarding mechanics

On the first forwarded call the client POSTs an
`initialize` request (protocolVersion `2025-03-26`,
clientInfo name `agentdocs`, version `0.1.0`), captures
the `Mcp-Session-Id` response header when one is
returned, POSTs `notifications/initialized`, then POSTs
the `tools/call` request with the session header
attached when captured. The session is reused for the
life of the process. Every POST carries
`Content-Type: application/json` and
`Accept: application/json, text/event-stream`, and
responses may be plain JSON or SSE (`data:` lines).

## CLI

Each tool is a subcommand taking one JSON argument
string:

```bash
npx @reneturcios/agentdocs get_agent_facts '{}'
npx @reneturcios/agentdocs get_public_url '{"url":"https://imbawallet.com/agent/howto"}'
npx @reneturcios/agentdocs list_docs_urls '{}'
npx @reneturcios/agentdocs --version
```

Output is the forwarded result content as JSON. Exit
codes: `0` on success, `1` on an `isError` result, `2`
on a usage error.

## MCP server

```bash
npx -y @reneturcios/agentdocs mcp
```

MCP client config:

```json
{
  "mcpServers": {
    "agentdocs": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentdocs", "mcp"]
    }
  }
}
```

## Docker

```bash
docker run -i ghcr.io/cloudcorprecords/agentdocs
docker run --rm ghcr.io/cloudcorprecords/agentdocs list_docs_urls '{}'
```

## Development

```bash
npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source
```

## License

MIT — Copyright (c) 2026 Rene Turcios