Agentic Terminal Directory MCP Server for Claude

Overview

The Agentic Terminal Directory (AT Directory) is a verified merchant index for agentic commerce on the payment rails Bitcoin and Tether actually use—Lightning, BOLT12, L402, and USDT across supported chains. Agents discover merchants, inspect trust tiers from Observer Protocol, and verify payment endpoints before transacting. The directory is never in the payment path.

Hosted MCP is at https://mcp.agenticterminal.ai/mcp. Source data and server code live in observer-protocol/at-directory.

Features

• Six tools: search_merchants, get_merchant, verify_payment_endpoint, list_categories, list_rails, whoami.
• Anonymous read access for discovery and rail verification.
• Observer Protocol trust tiers separate from agent-callable integration tiers.
• Hosted streamable HTTP plus optional local @agenticterminal/mcp-server stdio package.
• Web directory at agenticterminal.ai with matching data.

Use Cases

• Search gift-card merchants accepting Lightning in a target category.
• Inspect Bitrefill's attestation and agent endpoints before purchase.
• Verify a merchant's Lightning endpoint is live before sending sats.
• List supported USDT chains and filter merchants by rail.
• Check your agent identity with whoami when using directory credentials.

Installation

Claude (Connectors)

1. Add https://mcp.agenticterminal.ai/mcp as a custom connector—no install required.
2. Optionally install @agenticterminal/mcp-server globally for local stdio use.
3. Run search_merchants with rail and category filters.
4. Call verify_payment_endpoint before initiating payment with your wallet.

Claude Code

claude mcp add --transport http at-directory https://mcp.agenticterminal.ai/mcp
claude mcp list

Other MCP clients

Add the connector using the JSON configuration below in your MCP client settings.

Configuration

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

For authenticated setups:

{
  "mcpServers": {
    "at-directory": {
      "url": "https://mcp.agenticterminal.ai/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_DIRECTORY_ACCESS_CREDENTIAL"
      }
    }
  }
}

Optional DirectoryAccessCredential raises rate limits and unlocks review writes; discovery reads need no auth.

Examples

Merchant search

Search for merchants accepting Lightning in the gift-cards category.

Rail verification

Verify the Lightning payment endpoint for merchant bitrefill before checkout.

Merchant detail

Get full rails, agent endpoints, and attestation URL for merchant bitrefill.

Security

• Read OP trust tier and agent-callable tier before trusting a merchant.
• Use live verification results; do not skip verify_payment_endpoint for large payments.
• Agents bring their own wallet—never paste seeds or macaroons into chat.

Troubleshooting

Rate limited

Obtain a DirectoryAccessCredential or reduce query frequency.

Verification inconclusive

Some rails are attestation-only; read the tool response carefully.

Empty search

Broaden category or rail filters; confirm merchant data passed CI validation.

Local stdio errors

For dev, start the mock verifier per the repository README before stdio mode.

Duplicate Check

No existing Agentic Terminal Directory or agenticterminal.ai entry was found in content/mcp/. This differs from generic payment MCP servers because it is a read-only verified merchant directory, not a wallet or checkout processor.