Agentic Terminal Directory
Verified merchants accepting agentic payments on Lightning/L402/BOLT12/USDT — search, verify, pay.
Open source Repository Open in the app JSON README (API)
About
Verified merchants accepting agentic payments on Lightning/L402/BOLT12/USDT — search, verify, pay.
Details
- Kind
- MCP servers
- Topic
- Developer tools
- Publisher
- ai.agenticterminal
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Forks
- 4
- Open pull requests
- 4
- Last push
- 2026-08-18T23:58:13Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 02:00:17
- Updated
- 2026-08-29 03:00:08
- Origin id
ai.agenticterminal/directory
README
# AT Directory
**Where agents discover OP-verified merchants on the rails Bitcoin and Tether actually use.**
AT Directory indexes merchants that sell products, services, APIs, or content and accept Lightning, BOLT12, L402, or USDT (any chain), with trust attestations issued through [Observer Protocol](https://observerprotocol.org). It is the verified, agent-callable layer on top of the fragmented agent-payment landscape. It is **not** in the payment path — agents discover here and pay merchants directly.
- **MCP server** (primary product) — `@agenticterminal/mcp-server`, hosted at `mcp.agenticterminal.ai`.
- **Web directory** — [agenticterminal.ai](https://agenticterminal.ai), same data rendered for humans.
- **SKILL.md** — teaches an agent how to query and complete payment handoff.
## Status
Pre-v1, active build. Target: week of 2026-05-18 for a live Tether-meeting demo. v1 ships Tiers 1–2.
## Use it from an agent
```jsonc
// Hosted (recommended, no install)
{ "mcpServers": { "at-directory": { "url": "https://mcp.agenticterminal.ai/mcp" } } }
```
```bash
npm install -g @agenticterminal/mcp-server # local alternative
```
Six tools: `search_merchants`, `get_merchant`, `verify_payment_endpoint`, `list_categories`, `list_rails`, `whoami`. Reads are ungated — anonymous agents see all tiers and can transact with no setup. An Observer Protocol `DirectoryAccessCredential` raises rate limits and unlocks write access (reviews), but is not required to discover or transact. Full reference: [agenticterminal.ai/api-docs](https://agenticterminal.ai/api-docs).
## Repo layout
```
data/merchants/ One JSON file per merchant (the source of truth).
data/schema/ JSON Schema (Draft 2020-12) for merchant records.
data/categories.json Category taxonomy.
data/rails.json Supported rails + USDT chains.
data/LOGO-AUDIT.md Logo sourcing checklist.
packages/core/ Types, schema-validated load, search/filter.
packages/mcp-server/ stdio + hosted HTTP MCP server, rail verification.
packages/skill/ SKILL.md (canonical).
apps/web/ Next.js static directory + Netlify Functions.
deploy/mcp-server/ Dockerfile, systemd unit, DEPLOY runbook.
scripts/ Data validation (and one-time crawl tooling).
```
## Development
```bash
pnpm install
pnpm -r test # core + mcp-server unit/integration tests
pnpm -r typecheck
pnpm validate-data # schema-validate every merchant record
pnpm -F @at-directory/web dev # web at localhost:3000
pnpm -F @agenticterminal/mcp-server start:stdio # MCP over stdio
```
Local MCP with the mock verifier (until the real AT route lands):
```bash
pnpm -F @agenticterminal/mcp-server exec tsx src/dev/mock-verifier.ts &
AT_VERIFIER_URL=http://127.0.0.1:8787 \
pnpm -F @agenticterminal/mcp-server start:stdio
```
## Data model
Every merchant carries two **orthogonal** signals — read both:
- **OP trust tier** (the merchant): 1 self-attested · 2 operator-verified. v1 Tier 2 = AT operator transacted and confirmed; the bilateral counterparty-attestation model lands in v1.x.
- **Agent-callable tier** (the integration): `full-api` · `structured-handoff` · `human-checkout`.
**The trust tier gates nothing.** Reads are ungated, every tier is visible to anonymous agents, and
an agent can transact with a Tier 1 merchant with no setup. The tier is evidence for a caller to
weigh, not a decision this directory has made on its behalf. Nothing is refused on the basis of it.
Schema is enforced in CI (`pnpm validate-data`) and on every load. USDT rails require a `chain`; Tier 2+ non-integrated records require an `op_attestation_url`; an `op_trust_tier` of `3` is rejected on ingest, which is why the model above stops at 2.
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md). Merchants can self-register at [agenticterminal.ai/submit](https://agenticterminal.ai/submit) — submissions open a PR for review and land at Tier 1 until verified.
## Documents
- [Scope](../AT-Directory-v1-Scope.md) — positioning, inclusion criteria, definition of done.
- [Spec](../AT-Directory-v1-Spec.md) — implementation contract.
## License
MIT.