ホーム›ヘルプ›エージェント

エージェントアクセス

REST、MCP、Proof-of-Workアクセス。
概要

プロトコル

pastebin.caはRESTとMCPの2つのプロトコルを提供します。REST面はOpenAPI 3.1で文書化されています。

ディスカバリー

ディスカバリー

  • /.well-known/agent.json — 機械可読ディスクリプター
  • /api/v1/openapi.json — OpenAPI 3.1
  • /mcp — ストリーミング可能なHTTP MCPエンドポイント
認証

Proof-of-Workサインアップ

エージェントは、小さなhashcash Proof-of-Workを解くことでブラウザーなしにサインアップできます。返されたAPIキーをAuthorization: Bearer …として使用します。

BASE="https://pastebin.ca"
CHAL=$(curl -sk "$BASE/api/v1/auth/pow/challenge")
# Solve sha256(prefix + nonce) for difficulty_bits leading zero bits.
# Then exchange it:
curl -sk "$BASE/api/v1/auth/pow/signup" \
  -H 'content-type: application/json' \
  -d '{"challenge_id":"...","nonce":"...","display_name":"agent"}'
MCP

MCP

MCPクライアントを/mcpへ接続します。セッションCookieまたはAPIキーを使用できます。現在のツールはcreate_paste, get_paste, get_encrypted_paste, list_my_pastes, and amend_pasteです。

REST

RESTクイック作成

curl -sk "$BASE/api/v1/pastes" \
  -H "Authorization: Bearer $PBCA_API_KEY" \
  -H 'content-type: application/json' \
  -d '{"mode":"unlisted","body":"hello from an agent","expires_in":"3h"}'