_____ _____ ____ _ _ _____ ___ ____ _ ____ ___ |_ _| ____/ ___| | | | ___/ _ \| _ \ / \ / ___|_ _| | | | _|| | | |_| | |_ | | | | |_) | / _ \| | _ | | | | | |__| |___| _ | _|| |_| | _ < / ___ \ |_| || | |_| |_____\____|_| |_|_| \___/|_| \_\/_/ \_\____|___|
gateway v0.3.6
machine-readable information and compute services for autonomous AI agents
A Tech For People Global Corp initiative — TechForAGI extends the parent company’s agent-native product line.
Agent Channels Sandbox: agents can self-register at POST /agent-channels/register, receive a bearer token, and call services under quotas — no payment required; usage is metered; future x402/USDC planned.
TechForAGI Gateway is an agent-native API gateway, not a traditional SaaS dashboard. Designed so autonomous AI agents can discover available services, request cost estimates, submit processing tasks, and receive structured machine-readable responses in TOON or JSON format.
Every response includes a request_id, cost_usd,
and latency_ms so agents can track usage and costs without
a separate billing call.
# not a chatbot. not a dashboard. not a blockchain. a gateway.
Autonomous agents that need trusted compute with machine-readable discovery and structured responses.
Engineers building AI agents who need reliable, cost-predictable APIs with OpenAPI specs and MCP tool definitions.
Orchestrators that route tasks to specialized compute with deterministic pricing.
Future marketplaces where agents discover, evaluate, and pay for third-party services.
# four steps to consume a service
step 1: discover
Fetch /.well-known/agent.json or/services.toon to list available services.
step 2: quote
POST to /quote with service ID and token estimate. Receive cost_usd + latency_ms.
step 3: process
POST to /process with input. Receive structured response with full meta block.
step 4: pay (future)
x402 micropayments + credit billing planned for Phase 3.
# 1. discover services
GET https://api.techforagi.com/services.toon
Accept: text/toon
# 2. quote before processing
POST https://api.techforagi.com/quote
{
"service_id": "document.basic_extract",
"input_tokens_estimate": 500
}
# 3. process request
POST https://api.techforagi.com/process
Accept: text/toon
{
"service_id": "document.basic_extract",
"input": { "text": "Contact: alice@example.com. Visit https://techforagi.com." }
}# see full catalog: /services · /services.json · /services.toon
| id | name | description | price | unit | settlement | status |
|---|---|---|---|---|---|---|
url.readability.extract |
URL Readability Extract | Fetch a public URL and extract clean main text, title, excerpt, byline, word count, links, and metadata using Mozilla Readability. Validates and blocks unsafe URLs (localhost, private IPs, metadata endpoints). | $0.003 | request | USDC | active |
document.basic_extract |
Document Basic Extract | Extract basic structured data from plain text using deterministic regex rules (no LLM/AI). Finds emails, URLs, dates, amounts, phone numbers, hashtags, mentions, headings, and word/line/char counts. | $0.002 | request | USDC | active |
web.metadata.audit |
Web Metadata Audit | Fetch a public HTML page and extract title, meta description, canonical, OpenGraph, Twitter/X card tags, JSON-LD blocks and @types, robots meta, language, heading/link/image counts, metadata quality score, and missing_fields. Same URL safety as url.readability.extract. | $0.003 | request | USDC | active |
robots.policy.check |
Robots.txt Policy Check | Fetch /robots.txt for the URL origin (safe http/https only), parse Allow/Disallow groups, evaluate whether the target URL path is allowed for a user-agent (default TechForAGI-Agent). Missing robots.txt → allowed with decision allow_by_default. | $0.002 | request | USDC | active |
captions.parse |
Captions Parse | Deterministically parse SRT, WebVTT, or plain transcript text into segments (start, end, text), counts, and duration when timestamps exist. No external fetch; no YouTube. | $0.002 | request | USDC | active |
youtube.captions.get |
YouTube Captions (Deprecated) | DEPRECATED: YouTube caption retrieval is no longer available. POST /process returns HTTP 410 for this service_id. | $0 | request | USDC | deprecated |
youtube.video.formats |
YouTube Video Formats (Deprecated) | DEPRECATED: YouTube format listing is no longer available. POST /process returns HTTP 410 for this service_id. | $0 | request | USDC | deprecated |
text.summarize |
Text Summarize (Deprecated) | DEPRECATED: Mock summarization service kept for backwards compatibility. Use document.basic_extract for real extraction. | $0.001 | request | USDC | deprecated |
doc.extract |
Document Extract (Deprecated) | DEPRECATED: Mock extraction service kept for backwards compatibility. Use document.basic_extract for real extraction. | $0.004 | request | USDC | deprecated |
knowledge.search |
Knowledge Search (Deprecated) | DEPRECATED: Mock search service kept for backwards compatibility. | $0.002 | request | USDC | deprecated |
# usage is metered to Supabase. no payment is required in Phase 3. · /pricing.json · /pricing.toon
| service_id | price_usd | unit | settlement | protocols planned | status |
|---|---|---|---|---|---|
url.readability.extract |
$0.003 | request | USDC | x402, credits, api_key | active |
document.basic_extract |
$0.002 | request | USDC | x402, credits, api_key | active |
web.metadata.audit |
$0.003 | request | USDC | x402, credits, api_key | active |
robots.policy.check |
$0.002 | request | USDC | x402, credits, api_key | active |
captions.parse |
$0.002 | request | USDC | x402, credits, api_key | active |
youtube.captions.get |
$0 | request | USDC | x402, credits, api_key | deprecated |
youtube.video.formats |
$0 | request | USDC | x402, credits, api_key | deprecated |
text.summarize |
$0.001 | request | USDC | x402, credits, api_key | deprecated |
doc.extract |
$0.004 | request | USDC | x402, credits, api_key | deprecated |
knowledge.search |
$0.002 | request | USDC | x402, credits, api_key | deprecated |
# payments are not active in Phase 3. usage is metered. future versions planned to support x402-compatible stablecoin settlement using USDC.
# full catalog: /capabilities.json · /capabilities.toon
risk levels: low = safe for autonomous agents · medium = review before automation
~40% fewer tokens than JSON. Tabular arrays, YAML-style objects. Ideal for LLM context windows.
Send Accept: text/toon.
services[10]{id,name,price_usd,status}:
url.readability.extract,URL Readability Extract,0.003,active
document.basic_extract,Document Basic Extract,0.002,active
youtube.captions.get,YouTube Captions (Deprecated),0.006,deprecated
youtube.video.formats,YouTube Video Formats (Deprecated),0.008,deprecated
text.summarize,Text Summarize (Deprecated),0.001,deprecated
doc.extract,Document Extract (Deprecated),0.004,deprecated
knowledge.search,Knowledge Search (Deprecated),0.002,deprecated
Standard JSON. Default format for all API endpoints.
Send Accept: application/json.
{
"meta": {
"request_id": "req_abc123",
"cost_usd": 0.001,
"status": "ok"
},
"result": { "summary": "..." }
}
TechForAGI exposes a JSON-RPC 2.0 endpoint at POST /mcp
compatible with the Model Context Protocol.
# available mcp tools
get_services | list all services |
get_pricing | get pricing metadata |
get_capabilities | list platform capabilities |
quote_service | estimate cost |
process_text | summarize text |
extract_document | extract fields |
search_knowledge | search knowledge |
get_payment_future_contract | get payment contract |
POST /mcp
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Unique req_xxx ID for tracing, debugging, and audit.
Actual cost in USD so agents can track spend without a billing call.
Wall-clock latency for retry and timeout decisions.
Payments are not active in Phase 3. TechForAGI Gateway meters usage to Supabase and exposes per-service pricing and a future payment contract so autonomous agents and developers can understand how paid access will work. Future versions are planned to support x402-compatible stablecoin settlement, initially using USDC.
| method | status | notes |
|---|---|---|
api_key | current | traditional key-based billing |
credits | current | prepaid credit balance |
x402 | phase 3 | HTTP 402 micropayments |
stablecoin / USDC | phase 3 | on-chain settlement on Base |
wallet_signature | phase 3 | decentralized agent identity |
# future payment contract
GET /payments/future-contract.json
→ {
"active": false,
"protocol": "x402",
"settlement_asset": "USDC",
"chain": "Base",
"flow": [...8 steps...]
}Q: What is TechForAGI Gateway?
A: An agent-native API gateway. Not a chatbot platform. Not a dashboard. A lightweight compute gateway designed for AI agents to discover and consume trusted services.
Q: What is TOON format?
A: Token-Oriented Object Notation. ~40% fewer tokens than JSON. Tabular arrays with
key[N]{fields} header, YAML-style indented objects. Send Accept: text/toon.
Q: Is TechForAGI an MCP server?
A: Yes. JSON-RPC 2.0 at POST /mcp. Tools include get_services, get_pricing,
get_capabilities, quote_service, extract_url_readability, extract_document_basic,
process_text, extract_document, search_knowledge, get_payment_future_contract,
plus deprecated YouTube tool names (listed but not executable).
Q: How does payment work?
A: No payment is required in Phase 3. Usage is metered to Supabase for every request. Future versions planned to support x402 HTTP micropayments and USDC stablecoin settlement. See /payments/future-contract.json.
Q: What is the pricing model?
A: Per-request USD pricing. url.readability.extract: $0.003/req. document.basic_extract: $0.002/req. YouTube-related services are deprecated (catalog only). No subscription required. No payment active in Phase 3. See /pricing.json.
Q: Does TechForAGI support autonomous agent payments without human intervention?
A: Not yet. Planned for Phase 3 using the x402 protocol and USDC on Base. Agents can inspect the full payment flow at /payments/future-contract.json.
Q: What is USDC and why is it the settlement asset?
A: USDC is a USD-pegged stablecoin. It enables autonomous agents to pay for services programmatically without fiat conversion. No USDC is collected in Phase 3.
Q: What capabilities does TechForAGI have?
A: 16 capabilities including web readability extraction, document field extraction, summarization (deprecated mock), cost estimation, MCP tool calls, agent discovery, usage metering, and future stablecoin payments. See /capabilities.json.
# start here — fetch the agent manifest
GET /.well-known/agent.json