Skip to content
Back to search

advbox.mcp-server

Remote Streamable HTTP MCP server for read-only ADVBOX API access.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/davidmrtns/advbox.mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/davidmrtns/advbox.mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/davidmrtns--advbox-mcp-server/badge.svg)](/listings/davidmrtns--advbox-mcp-server)

HTML

<a href="/listings/davidmrtns--advbox-mcp-server"><img src="/api/listings/davidmrtns--advbox-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 86 lines
  1. # ADVBOX MCP Server
  2. Remote Streamable HTTP MCP server for read-only ADVBOX API access.
  3. ## Development
  4. Copy the environment template and adjust the values as needed:
  5. ```bash
  6. cp .env.example .env
  7. ```
  8. ```bash
  9. npm start
  10. npm run inspect
  11. ```
  12. The MCP endpoint is available at `http://127.0.0.1:3000/mcp` by default.
  13. ## Configuration
  14. - `HOST`: HTTP bind address. Default: `127.0.0.1`. Use `0.0.0.0` in containers.
  15. - `PORT`: HTTP port. Default: `3000`.
  16. - `ALLOWED_HOSTS`: comma-separated hostnames accepted by the `Host` header. Default: `localhost,127.0.0.1,[::1]`.
  17. - `ALLOWED_ORIGINS`: comma-separated origin hostnames accepted by the `Origin` header. Default: `localhost,127.0.0.1,[::1]`.
  18. - `LOG_LEVEL`: structured log level: `debug`, `info`, `warn`, or `error`. Default: `info`.
  19. Example for a container exposed through a public domain:
  20. ```bash
  21. HOST=0.0.0.0 \
  22. PORT=3000 \
  23. ALLOWED_HOSTS=mcp.example.com \
  24. ALLOWED_ORIGINS=mcp.example.com \
  25. npm start
  26. ```
  27. Browsers send an `Origin` header; non-browser MCP clients normally do not. For a proxy or public deployment, configure `ALLOWED_HOSTS` and `ALLOWED_ORIGINS` for the actual public hostnames instead of allowing all origins.
  28. ## Docker
  29. Build and run the minimal production image:
  30. ```bash
  31. docker build -t advbox-mcp-server .
  32. docker run --rm -p 3000:3000 --env-file .env advbox-mcp-server
  33. ```
  34. The container binds to `0.0.0.0:3000` and exposes `/health/live` and `/health/ready`.
  35. ## Observability
  36. - `/health/live`: liveness check; no Host or Origin validation is required.
  37. - `/health/ready`: readiness check; no Host or Origin validation is required.
  38. - Logs are emitted as JSON to stdout/stderr, including request ID, method, path, status and duration.
  39. - Responses include `x-request-id`, which may be supplied by the caller or generated by the server.
  40. - SIGTERM and SIGINT trigger graceful HTTP and MCP shutdown.
  41. ## ADVBOX tools
  42. The server exposes read-only tools for account settings, contacts, lawsuits, movements, tasks, transactions and documents.
  43. Set `ADVBOX_TOKEN` and optionally `ADVBOX_API_URL` in `.env`. Requests are limited to 30 per minute per server process and API responses are truncated above 150,000 characters.
  44. ## HTTP utilities and API services
  45. The generic HTTP client lives in [`src/utils/http-client.ts`](/src/utils/http-client.ts):
  46. ```ts
  47. import { HttpClient } from './utils/index.js';
  48. const api = new HttpClient('https://api.example.com', {
  49. timeoutMs: 10_000,
  50. headers: { Authorization: 'Bearer token' },
  51. });
  52. ```
  53. API-specific endpoints belong in [`src/services/`](/src/services) and compose this client:
  54. ```ts
  55. import { NotesService } from './services/index.js';
  56. const notes = new NotesService(api);
  57. await notes.list();
  58. await notes.create({ text: 'hello' });
  59. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.