Documentation

1. What is Portal?

Portal is the agent services layer — helping AI agents find the right services, get verified working code, and sign up autonomously.

Two core features:

Verified Documentation: Search for how to do something → get tested code snippets with benchmarks
Autonomous Signups: Agent needs an API key → Portal signs up automatically and returns credentials

All endpoints are protected by x402 micropayments — pay with USDC on Base. No API keys, no subscriptions.

2. Installation

MCP Server (Recommended)

Add Portal to your agent's MCP configuration:

{
  "mcpServers": {
    "portal": {
      "command": "npx",
      "args": ["@getportal/mcp"]
    }
  }
}

Or run directly:

npx @getportal/mcp

Direct API

For non-MCP agents, call the API directly with x402 payment headers.

3. Wallet Setup

Portal accepts USDC payments on Base (eip155:8453). You'll need a wallet with USDC to pay for snippets and signups.

Create a wallet (Coinbase, MetaMask, or any EVM wallet)
Bridge USDC to Base network
Fund the wallet with a few dollars (snippets $0.05, signups $0.50–$2.00)

💡 Tip: The MCP server will generate a wallet at ~/.portal/wallet.json on first run. Deposit USDC to that address.

4. Verified Documentation

Search (Free)

GET /v1/search?q=how+to+transcribe+audio

Returns matching services and code snippets ranked by relevance.

Get Snippet ($0.05)

GET /v1/snippet/deepgram-transcribe-ts
X-Payment: x402...

Returns verified, tested code with benchmarks (latency, cost per unit).

Compare Services (Free)

GET /v1/usecase/transcription

Compare all services for a use case with pricing and features.

5. Autonomous Signups

Create Signup ($0.50–$2.00)

POST /signup
Content-Type: application/json
X-PAYMENT: <x402 payment>

{
  "service": "resend",
  "email_mode": "portal_managed"
}

Check Status

GET /jobs/portal_abc123_xyz789

Get Credentials

GET /credentials/portal_abc123_xyz789

⚠️ Important: Credentials are one-time retrieval. They're deleted immediately after you access them and expire 5 minutes after job completion.

6. Supported Services

Documentation (15+ services)

Category	Services
Transcription	Deepgram, AssemblyAI, Groq Whisper
Email	Resend, SendGrid, Postmark
Sandboxes	E2B, Modal, Daytona
Scraping	Firecrawl, Browserbase, Jina
LLM APIs	OpenRouter, Together, Fireworks, Groq

Autonomous Signups

Service	Price	Time	Returns
Resend	$0.50	~20s	API key
Railway	$0.50	~25s	API key
Vercel	$1.00	~30s	API key
Supabase	$1.00	~35s	API key
Cloudflare	$1.00	~30s	API key

7. MCP Tools

Tool	Description	Cost
portal_search	Search for services and snippets	Free
portal_snippet	Get verified code	$0.05
portal_compare	Compare services for a use case	Free
portal_signup	Autonomous service registration	$0.50-2.00
portal_wallet	Check x402 balance	Free

8. Security

Credentials encrypted at rest
One-time retrieval (deleted after access)
5-minute expiration window
No credential logging or storage after retrieval
Payment = authentication (no API keys to manage)

9. Full API Reference

See /llms.txt for complete API documentation in a machine-readable format.