Build with Nectar

Quickstart

# Discover
GET /v1/catalog
GET /v1/pricing

# Unpaid call → HTTP 402
POST /v1/research-url
{"url":"https://example.com"}

# After sending USDC on Base:
POST /v1/pay
{"endpoint":"research-url","txHash":"0x…"}

# Authorized call
POST /v1/research-url
Authorization: Bearer rcpt_…
{"url":"https://example.com"}

Payment

1. Read the price from /v1/pricing or from a 402 response.
2. Transfer at least that amount of native USDC on Base to the published settlement address.
3. Call POST /v1/pay with endpoint and txHash. A single-use receiptId is returned.
4. Invoke the tool with Authorization: Bearer <receiptId>.

Cards and bank transfers are not accepted. Settlement is on-chain USDC only.

Discovery

• /v1/pricing — prices and settlement
• /v1/catalog — tool list
• /openapi.json — OpenAPI 3.1
• /mcp — MCP JSON-RPC for tool hosts
• /llms.txt — map for language models
• /agent-skill.md — skill notes for agents
• /.well-known/nectar.json, /.well-known/mcp.json

MCP

POST /mcp accepts JSON-RPC 2.0. Free tools: nectar_pricing. After Base USDC transfer, nectar_pay returns a receipt; pass receipt_id into paid tools such as research_url.

POST /mcp
{"jsonrpc":"2.0","id":1,"method":"tools/list"}

POST /mcp
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"nectar_pricing","arguments":{}}}

Tool reference

Policies

• Use the API only for lawful purposes.
• Respect robots.txt and third-party terms when requesting remote content.
• Do not reuse spent receipts or attempt to circumvent payment.