Skip to content

Portal v0.1.0 — first public release

Choose a tag to compare

@0motionguy 0motionguy released this 19 Apr 12:43
· 84 commits to main since this release

Portal is an open HTTP standard that lets any LLM client visit a service's tools without pre-configuration. Two endpoints, one manifest, fire-and-forget. A complement to MCP, not a replacement: MCP = installed tools, Portal = drive-by visits.

What ships in v0.1.0

  • Spec — docs/spec-v0.1.0.md, public domain (CC0). One page of core + three appendices.
  • Conformance — 30 vectors + ajv + lean dual-validator with CI-enforced parity
  • TypeScript SDK — @visitportal/visit, 2.25 kB gzipped, 14 tests
  • CLI — visit-portal info | call | conformance
  • Reference provider — reference/star-screener (Hono, 30 repos, 12 maintainers)
  • Benchmark — 48-cell real count_tokens matrix
  • Web — Next.js site with /, /docs, /bench, /directory

Measured numbers

Tool count MCP input tokens Portal Ratio
10 1,956 172 11.4×
100 13,929 172 81.0×
400 54,677 172 317.9×

All numbers from Anthropic's count_tokens API, seed 42, Sonnet 4.5 + Opus 4.5. Full matrix: packages/bench/results/tokens-matrix-v1.json. Reproduce with BENCH_MODE=count_tokens_only pnpm --filter @visitportal/bench bench.

Live URLs

Try it

pnpm install
bash scripts/demo.sh                           # 7s end-to-end
pnpm conformance https://starscreener.vercel.app/portal

Status

Phase Status
0 scaffold / 1 spec / 2 reference / 3 SDK / 5 bench / 6 demo / T1 one-pager / T2 Next.js / 6b interactive shipped
Python SDK / MCP adapter stretch, v0.2

See docs/ADOPTER-DEBRIEF.md for full session context.

License

Dual: Apache 2.0 for code, CC0 1.0 for the spec.


Built with Opus 4.7 for the Claude Code hackathon · April 2026