Agentic Terminal Directory

ai.agenticterminalPublished by agenticterminal.aiOfficial publisherv1.0.0Updated Oct 24, 2026

Verified merchants accepting agentic payments on Lightning/L402/BOLT12/USDT — search, verify, pay.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search and inspect merchants that accept agentic payments over Lightning, BOLT12, L402 or USDT, and check their payment endpoints.

What you can do
Provides six read-oriented tools over a hosted directory of merchants that accept agentic payments. search_merchants filters by rail, chain, category, agent-callable tier, trust tier and free text, ranked by trust tier then verification recency. get_merchant returns a full record with rails, payment endpoints and attestation, and verify_payment_endpoint runs a live check against a merchant's declared endpoint. list_categories and list_rails give the taxonomy and rail counts, and whoami reports the caller's credential state and rate limits.
When to use it
Useful when an assistant needs to find a merchant or service that accepts Lightning, BOLT12, L402 or USDT, or to check whether a merchant's payment endpoint is live before handing off a payment. Reads are ungated, so it can be added for discovery without setup.
Requirements
A remote streamable HTTP endpoint; no install, account or API key is needed for reads. An Observer Protocol DirectoryAccessCredential is optional and only raises rate limits and unlocks write access such as reviews.
Before you install
The directory is not in the payment path: the assistant discovers merchants here and pays them directly, so payment details and funds are handled outside this server. Trust tiers are evidence to weigh, not a guarantee, and a Tier 1 merchant is self-attested. verify_payment_endpoint makes live requests to third-party endpoints. A credential, if supplied, unlocks write actions such as reviews.

Installation

In SourceWeft

  1. Open Agentic Terminal Directory in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.agenticterminal%2Fdirectory/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentic-terminal-directory": {
      "type": "http",
      "url": "https://mcp.agenticterminal.ai/mcp"
    }
  }
}

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. 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, 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.

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 installpnpm -r test          # core + mcp-server unit/integration testspnpm -r typecheckpnpm validate-data    # schema-validate every merchant recordpnpm -F @at-directory/web dev          # web at localhost:3000pnpm -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. Merchants and researchers submit by email to [email protected]; accepted entries land at Tier 1 until verified.

The self-registration form at /submit is not operational. apps/web/app/submit/page.tsx has had TALLY_FORM_ID = 'TODO' since 883c183 (2026-06-22, which replaced the earlier GitHub-issue form) and no commit since has changed it, so the page renders an email fallback and embeds no form. apps/web/netlify/functions/submit-merchant.ts exists and is complete, but it needs TURNSTILE_SECRET_KEY, GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY and GITHUB_INSTALLATION_ID in the Netlify environment and nothing in this repo shows whether they are set. This README and CONTRIBUTING.md advertised the form as the working route anyway until 2026-09-15, when an inbound bounty submission pointed it out. Do not re-advertise it until the form ID is set and a test submission has actually opened a PR.

Documents

  • Scope — positioning, inclusion criteria, definition of done.
  • Spec — implementation contract.

License

MIT.

Source: README.md at commit 12e7de4

Tools

6

search_merchants

Search OP-verified merchants by rail, chain, category, agent-callable tier, trust tier, and free text. Ranked by trust tier then verification recency.

Parametersrailchainlimitquerycategoryaccepts_usdctrust_tier_minagent_callable_tier

get_merchant

Get the full record for one merchant including all rails, payment endpoints, and OP attestation. Tier 2+ requires an AT credential.

Parametersidrequired

verify_payment_endpoint

Run a live check against a merchant's declared payment endpoint for a rail. Returns health, detail, and rail-specific evidence.

Parametersrailrequiredmerchant_idrequired

list_categories

List the category taxonomy with merchant counts.

Takes no parameters.

list_rails

List supported payment rails and their current merchant counts.

Takes no parameters.

whoami

Report the resolved credential state and rate limits for the calling agent.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts