Hacker News

by Hacker News API

45 txns

2 agents

About

Official Hacker News API powered by Firebase. Access stories, comments, jobs, polls, and user profiles in real-time. No authentication required. Endpoints include top/new/best/ask/show/job stories, individual items by ID, and user profiles.

Access Data

For AI Agents

MCP Server

Install the x402 MCP server to let your AI agent access this data with automatic USDC payments on Base.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["@serendb/x402-mcp-server"],
      "env": {
        "X402_GATEWAY_URL": "https://x402.serendb.com",
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

Replace 0x... with your wallet private key.

macOS / Linux

claude mcp add x402 \
  -e X402_GATEWAY_URL=https://x402.serendb.com \
  -e WALLET_PRIVATE_KEY=0x... \
  -- npx -y @serendb/x402-mcp-server

Windows (PowerShell)

claude mcp add x402 `
  -e X402_GATEWAY_URL=https://x402.serendb.com `
  -e WALLET_PRIVATE_KEY=0x... `
  '--' npx -y @serendb/x402-mcp-server

Gemini CLI

Replace 0x... with your wallet private key.

gemini mcp add x402 \
  -e X402_GATEWAY_URL=https://x402.serendb.com \
  -e WALLET_PRIVATE_KEY=0x... \
  -- npx -y @serendb/x402-mcp-server

Codex CLI

Replace 0x... with your wallet private key.

codex mcp add x402 \
  --env X402_GATEWAY_URL=https://x402.serendb.com \
  --env WALLET_PRIVATE_KEY=0x... \
  -- npx -y @serendb/x402-mcp-server

Cursor

Important: Cursor has a 60s timeout. Pre-install globally first: npm install -g @serendb/x402-mcp-server

First, install globally to avoid timeout issues:

npm install -g @serendb/x402-mcp-server

Then add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "x402": {
      "command": "x402-mcp-server",
      "args": [],
      "env": {
        "X402_GATEWAY_URL": "https://x402.serendb.com",
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Also works with Windsurf, Zed, and other MCP-compatible clients. See the full setup guide for details.

Full Setup Guide npm Package

For Developers

Direct HTTP API

Access data directly via HTTP using the x402 payment protocol.

How x402 Payments Work

Send your query request to the gateway
Receive HTTP 402 with payment requirements (amount, wallet, EIP-712 data)
Sign the payment authorization with your wallet
Retry request with X-PAYMENT header containing the signature
Receive your data - payment settles automatically via USDC on Base

Step 1: Get Payment Requirements

curl -X POST https://x402.serendb.com/api/proxy \
  -H "Content-Type: application/json" \
  -d '{
    "publisherId": "af2d7cbb-ca72-4031-9bbb-78c2cce6846e",
    "agentWallet": "0xYourWalletAddress",
    "request": {
      "method": "GET",
      "path": "/endpoint"
    }
  }'

This returns 402 Payment Required with the payment details you need to sign.

Step 2: Add Payment Header

After signing the EIP-712 authorization, add the base64-encoded signature:

curl -X POST https://x402.serendb.com/api/proxy \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64-encoded-signature>" \
  -d '{ ... }'

Get Help on Discord

Pricing

$0.0000/call

Pay per API call via x402 protocol

Publisher Details

Type: api

Added: January 2, 2026

Cache TTL: 300s

Related Publishers

Leviathan News & AI Advertising Network

by Leviathan News Advertising

GET /ad_test to browse placements, POST /api/v1/ad/confirm-payment/:id to submit campaigns, GET /api/v1/ad/analytics/:id for ad performance metrics

Crates.io Rust Package Registry

by crates.io

Official Rust package registry API. Search 215K+ crates, view download stats, check dependencies, and manage your packages. Write operations (publish, yank, owners) require your crates.io API token passed via Authorization header.

rustpackagesregistry+3

5 txns

2 agents

$0.0000/call