AI SENSE Free Public Tools について
AI SENSE Free Public Tools は、エージェントのワークフローや一般的な用途向けの公開 REST API と MCP ツールを集めたサービスです。アカウントや API キーなしで、キュー、リース、ハートビート、受信トレイ、人的承認などの連携を支援します。
主な機能
- 01ハートビート監視と未着信時の処理
- 02共有作業を調整するリース
- 03一時的な JSON ジョブキュー
- 04エージェント受信トレイと人的承認
- 05Webhook の受信とユーティリティ用エンドポイント
活用シーン
- 01ワーカーのチェックイン停止を検知
- 02複数ワーカーによる同一タスクの取得を防止
- 03プロデューサーとワーカー間で小規模な JSON ジョブを受け渡す
- 04人的承認に必要な情報を収集
MCP 対応
https://aisenseapi.com/mcp の MCP サーバーは、ハートビート、リース、キュー、エージェント受信トレイ、人的承認、Webhook 受信、一時ストレージ、URL 短縮、時刻、UUID のワークフローツールを公開します。アカウントや API キーは不要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://aisenseapi.com/mcpclaude mcp add --transport http com-aisenseapi-free-public-tools https://aisenseapi.com/mcp{"mcpServers":{"com-aisenseapi-free-public-tools":{"type":"http","url":"https://aisenseapi.com/mcp"}}}Cursor で開く{"servers":{"com-aisenseapi-free-public-tools":{"type":"http","url":"https://aisenseapi.com/mcp"}}}VS Code で開く{"mcpServers":{"com-aisenseapi-free-public-tools":{"type":"http","url":"https://aisenseapi.com/mcp"}}}{"mcpServers":{"com-aisenseapi-free-public-tools":{"serverUrl":"https://aisenseapi.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
66| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| timezone | string | いいえ | IANA タイムゾーンまたは UTC オフセット。例:Europe/Oslo、+02:00。 |
詳細
無料の公開 REST API - AI SENSE AS
API キー不要 | 登録不要 | 無料
AI SENSE AS(ノルウェー、オスロ)が提供しています。
全エンドポイントのリファレンス:API.md | リポジトリ:github.com/aisenseapi/aisense-free-public-rest-apis
ベース URL: https://aisenseapi.com/services/v1/
無料の公開 MCP エンドポイント
AI SENSE MCP サーバーのエンドポイントは次のとおりです。
https://aisenseapi.com/mcp
AI SENSE MCP サーバーは、Heartbeat、Lease、Agent Wake タスク、Agent
Inbox、人間による承認、Webhook の取得、一時ストレージ、URL 短縮、
時刻、UUID に対応しています。アカウントや API キーは不要です。Heartbeat では
create_heartbeat、read_heartbeat、ping_heartbeat を使用します。
Lease では create_lease_namespace、acquire_lease、renew_lease、
release_lease、complete_lease を使用します。Agent Inbox では
create_agent_inbox と read_agent_inbox を使用します。ツール一覧、データの境界、
クライアントの例については
MCP.md をご覧ください。
Agent Queue ツールでは、作成時に発行される読み取り、書き込み、ワーカー用の個別のトークンを使用します。セマンティック検索ツールでも、同様に読み取りトークンと書き込みトークンを使用します。
使用するツールの選択は AGENT-GUIDE.md から始め、その後 AGENT-QUICKSTART.md で Queue ワークフロー全体と 再試行の判断方法をご確認ください。
サーバーのバージョンは 1.13.1 と報告されています。AIQ、ip_datetime、
ping は引き続き REST のみで利用できますが、それ以外のワークフローツールと
以下の REST ユーティリティエンドポイントはツールとして提供されます。公式 MCP
Registry では、com.aisenseapi/free-public-tools バージョン 1.13.1 が
有効な最新バージョンとして掲載されており、公開日時は 2026 年 10 月 6 日
14:05 UTC です。
aamio には、https://aamio.at/mcp に独自の MCP エンドポイントがあります。11 個のツールで、エージェント同士が一時的に連絡を取り合うための機能を提供します。秘密の読み取りキーと公開書き込みアドレスを持つスレッド、それを超えて保持されるハッシュの受領証、プレゼンス、そしてニーズとオファーを公開するボード(https://board.aamio.at/)が含まれます。アカウントも API キーも不要です。公式 MCP Registry では at.aamio/aamio として掲載されています。AI SENSE エンドポイントは、これらのツールをプロキシしません。
Verifyum には、https://api.verifyum.com/mcp に専用の MCP エンドポイントがあります。アカウントや API キーなしで、Verifyum の 3 つの証明操作を利用できます。ファイルのハッシュ化は引き続きエージェントのマシン上で行われます。ブラウザのワークフロー、公開 HTTP API、公開済みプロトコルも引き続き利用できます。公式 MCP Registry では、バージョン
0.1.0 の com.verifyum/mcp として掲載されています。確定済みの証明は、
Verifyum Witness Layer の時間単位および日単位の Merkle チェックポイントにも追加されます。確定済みの証明ごとに 9 件の記録が関連付けられます。
| ティア | 記録 |
|---|---|
| 主要な証拠 | 証明ごとに 1 件の確定済み Solana Mainnet Memo トランザクション |
| 独立した裏付け | Bitcoin 上の時間単位の OpenTimestamps、日単位の適格な EU タイムスタンプ、日単位の証人署名付き Sigsum、日単位の Certificate Transparency 証明書 |
| 運用者の記録と可用性の冗長性 | Verifyum Ed25519 署名、GitHub チェックポイントログ、Software Heritage、Internet Archive |
Solana トランザクションが主要な証拠です。Solana の過去の履歴を詳しく調べるには、通常、アーカイブプロバイダーが必要です。Glasklar、Mullvad、Tillitis は、3 者中 2 者のクォーラムで Sigsum ダイジェストに共同署名します。適格なタイムスタンプは RFC 3161 を使用します。eIDAS 第 41 条第 2 項の推定効は、日次チェックポイントのルートのみに適用されます。Verifyum のユーザー証明は、適格な電子タイムスタンプではありません。Verifyum は適格なトラストサービスではありません。Software Heritage と Internet Archive は、何が保存されたかを示します。元のファイルがいつ存在していたかを立証するものではありません。チャネル数は品質スコアではありません。
確定済みの証明はすべて、 Telegram と Atom フィードでも告知されます。これらは告知チャネルです。 9 件の証拠記録には含まれません。タイムスタンプが示すのは告知の日時です。 元のファイルの日付については何も示しません。
エージェントは、指示、プロンプト、モデル、パラメーター、ツール呼び出し、出力から 1 件の意思決定記録をローカルで組み立て、そのコミットメントだけをアンカーすることもできます。この証明により、ブロック時刻まで、その正確な記録が変更されずに存在していたことが示されます。記録された設定でモデルが実際に実行されたことを証明するものではありません。
無料の公開 Agent2Agent(A2A)エンドポイント
Agent2Agent を話すエージェントは、次の場所でこれらの機能のうち5つを利用できます。
https://aisenseapi.com/a2a
JSON-RPC 2.0、プロトコルリビジョン 1.0 で、アカウントも API キーも不要です。エージェントカードは https://aisenseapi.com/.well-known/agent-card.json への通常の GET リクエストで取得できます。
A2A は、別のエージェントに作業を委任するためのプロトコルです。MCP はツールを公開するためのプロトコルです。このサービスの大半はツールであるため、A2A ではタスク型の機能を5つだけ提供します:agent-wake、human-approval、agent-inbox、webhook-capture、agent-queue。ほかのツールにはアクセスできません。MCP は、独自のツールスキーマを備えた、より豊富なワークフローのインターフェースとして機能します。A2A では、キュースキルがキューを作成し、3つのロールトークンを返します。キューへの追加、要求、確認応答は引き続き REST と MCP で行います。
A2A では、ワイヤ上にスキル ID がないため、呼び出し元は {"skill": "agent-wake", "arguments": { ... }} のように、メッセージのデータパートでスキル名を指定します。これはこのサービスが文書化している慣例であり、プロトコルで定義されたフィールドではありません。この指定がないメッセージは拒否されます。カードでは streaming と pushNotifications が false と宣言されているため、これらのメソッドは -32004 と -32003 を返します。ListTasks は空のページを返します。認証されたユーザーがいないため、タスク ID だけが唯一の認証情報となるからです。スキル、タスクの状態、レスポンス形式、エラーコードについては、API.md を参照してください。
SpeedUp(.su)- トークンコストを適切に測定
LLM 入力向けとうたわれるシリアライズ形式はどれも、単一のトークナイザーを基準に測定したトークン削減の主張を掲げています。エージェントのトラフィックは複数のベンダーにまたがるため、推測ではなく測定しました。6つの形式と33個の単一構造プローブを、5つの語彙ファミリー(OpenAI o200k、DeepSeek、Qwen、SentencePiece、Tekken)で評価し、各プロバイダー独自のトークンカウンターを正解値として使用しました。
SU-PROFILE.md- SpeedUp プロファイル:エージェント間テキスト向けの8つの記述規約。それぞれに測定済みのコストを記載していますspeedup/- 測定用ツール一式(Python、標準ライブラリのみ)、コーパス、プローブ、未加工の数値。独自のキーを使ってすべて再実行できます- 調査結果 - 測定で有効性が確認されたもの、確認されなかったもの、そして新たな形式の公開を見送った理由
主な数値:プレーン TSV は、5つの語彙の総合で最小化した JSON の平均0.82倍で、すべてのモデルにおいてトークン指向の形式を上回ります。その仕組みは、列を一度だけ宣言して値を位置順に送ることだけです(キーと値のペアごとに34%削減)。base64 はエンコード対象のプレーンテキストの3.9~4.6倍のコストがかかります。また、1文字のキー辞書は、5つの語彙のうち4つで完全なキーよりも効率が劣ります。
このコレクションの目的
多くのユーティリティ API では、基本操作にサインアップ、レート制限の段階制、または料金が必要です。このコレクションでは、そのすべてを省いています。URL を curl、Python、JavaScript、または LLM のツール定義に貼り付けるだけで、そのまま動作します。
このコレクションは、次の2段階の有用性をカバーします。
- ワークフローエンドポイント - パイプラインやエージェントシステムで実際の問題を解決するもの
- 標準ユーティリティ - ハッシュ、エンコード、UUID、時刻、暗号など、基本的な構成要素
クライアントを作成する前に知っておくべき3つのこと
これらはサービス全体に適用され、エラー処理の方法を左右します。
レスポンスキーはエンドポイント名と同じです。 /md5_hash は
md5_hash、/random_color は random_color、/ping は ping を返します。
汎用の data や result でラップされることはありません。キーを推測しないでください。
すべてのキーは API.md に記載されています。
エラーは通常、2xx以外のHTTPステータスとともに {"error": "message"} の形式で返されます。
ステータスと error フィールドの両方を確認してください。従来のウォレット生成
ハンドラーは、HTTP 200でエラーオブジェクトを返す場合があります。ワークフローの
エンドポイントは、競合の場合の409や、まだ削除されていない期限切れレコードの場合の
410など、2xx以外のステータスを使用します。削除後は、同じIDに対して404が返されます。
不明なルートも404を返します。追加のエラーについては、各エンドポイントを参照してください。
レート制限は、IPごとに1日5000リクエストです。 制限を超えると、
ほかのエラーと同じフラットな形式でHTTP 429が返されます。カウントは、3月下旬から
10月下旬まではUTC 22:00、それ以外の期間はUTC 23:00にリセットされます
(ノルウェーの午前0時、タイムゾーンはEurope/Oslo)。429レスポンスには、
リセットまでの秒数を示す Retry-After が含まれます。
重要度の高いエンドポイント
ハートビート - ワーカーからのチェックイン停止を把握する
想定するチェックイン間隔、猶予期間、期限を逃した場合のアクションを指定して モニターを作成します。アクションでは、公開WebhookにPOSTするか、既存のAgent Wake Webhookタスクを起動できます。
curl -X POST https://aisenseapi.com/services/v1/heartbeat \
-H "Content-Type: application/json" \
-d '{
"expect_every_seconds": 300,
"grace_seconds": 60,
"on_miss": {
"url": "https://example.com/agent-offline",
"payload": { "agent": "worker-7" }
}
}'
レスポンスには、推測困難な heartbeat_id、ping_url、status_url が含まれます。
正常なサイクルごとに、ping URLへPOSTしてください。各pingによって、想定される期限が
更新されます。固定された24時間の有効期限は延長されません。期限を逃すと、再試行なしで
1回だけアクションが実行されます。
MCP クライアントでは、同じ状態を扱うために create_heartbeat、read_heartbeat、
ping_heartbeat を使用できます。
Webhookの送信先は、作成時と配信時にSSRF対策の確認が行われます。プライベートおよび
予約済みアドレス、URL認証情報、フラグメント、リダイレクトはブロックされます。
状態とレスポンスフィールドについては API.md を参照してください。
リース - 共有エージェント作業で勝者を1つにする
リースを使うと、アカウントなしでワーカーを調整できます。プライベートな名前空間を 作成し、短時間キーを確保します。
curl -X POST https://aisenseapi.com/services/v1/lease/namespace \
-H "Content-Type: application/json" -d '{}'
curl -X POST https://aisenseapi.com/services/v1/lease \
-H "Content-Type: application/json" \
-d '{
"namespace": "ns_...",
"key": "invoice:2026-09-05",
"ttl_seconds": 60,
"fingerprint": "charge-order-501"
}'
確保に成功したワーカーには、owner_token と単調増加する fencing_token が渡されます。
リースが保持されている間、2番目のワーカーにはHTTP 409が返されます。所有者はリースを
更新、解放したり、JSON結果を指定して完了したりできます。後続の呼び出し元は、同じキーと
フィンガープリントを使って、完了済みの結果を再利用できます。
リースには、最初に取得されてから24時間後の固定された絶対有効期限があります。
更新しても延長されません。生のキー、名前空間、所有者トークン、フィンガープリントは
保存されません。取得から完了までの詳しい流れについては API.md を参照してください。
対応するMCPツールは、create_lease_namespace、acquire_lease、
renew_lease、release_lease、complete_lease です。
Agent Queue - 一時的な作業を共有する
Agent Queue は、プロデューサーとワーカーが小さな JSON ジョブを共有するためのキューを提供します。
curl -X POST https://aisenseapi.com/services/v1/queue \
-H "Content-Type: application/json" -d '{}'
curl -X POST https://aisenseapi.com/services/v1/queue/QUEUE_ID/jobs \
-H "Authorization: Bearer WRITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"job_key":"report:42","payload":{"report_id":42}}'
curl -X POST https://aisenseapi.com/services/v1/queue/QUEUE_ID/claim \
-H "Authorization: Bearer WORKER_TOKEN" \
-H "Content-Type: application/json" -d '{"visibility_timeout":60}'
大文字のプレースホルダーを作成レスポンスの値に置き換えてください。3 つのトークンは保持してください。これらは一度しか発行されません。クレームすると、秘密の receipt を含むジョブが 1 つ返されます。空の場合は job: null が返されます。ワーカーは作業を実行した後、ワーカートークンを使って {"receipt":"RECEIPT"} を /queue/QUEUE_ID/jobs/JOB_ID/ack に POST します。同じレシートを使って、アクティブなクレームを解放または更新できます。オブザーバーは読み取りトークンを使って、キューの件数と個々のジョブを読み取ります。認証情報はヘッダーに含め、URL には含めないでください。
キューとすべてのジョブは、キューの作成からちょうど 24 時間後に期限切れになります。エンキュー、クレーム、更新、完了を行っても、この期限は延長されません。制限は、キューの存続期間中に異なるジョブが 100 件、ジョブあたりエンコード済み JSON が 16 KiB、クレーム試行が 5 回、クライアント IP あたり 24 時間に新規キューが 20 件です。表示時間は 30~900 秒で、デフォルトは 60 秒です。ジョブキーとペイロードを再度指定すると、既存のジョブが返されます。ペイロードが異なる場合は競合になります。
クレームの期限が切れるか解放されると、ジョブが再度配信されることがあります。キューの期限切れや試行回数の上限により、ジョブが未完了のまま残る場合があります。初回の配信と厳密に 1 回の実行は保証されません。外部の処理は冪等にしてください。このサービスはキューの状態を保持しますが、ジョブの実行、URL の取得、コールバックの送信は行いません。
MCP クライアントは 8 つのキューツールを使用します。A2A クライアントは agent-queue スキルを指定します。このスキルはキューを作成し、3 つのロールトークンを返します。エンキュー、クレーム、確認応答は REST または MCP で行います。
Queue API reference、 MCP tools、 website guideを参照してください。
Semantic search - 意味から以前のメモを見つける
Semantic search は、エージェントの短いメモをコレクションに 24 時間保存し、表現や言語が異なっていても、意味に基づいて見つけます。
curl https://aisenseapi.com/services/v1/semantic_search
curl -X POST https://aisenseapi.com/services/v1/semantic_search/COLLECTION_ID/notes \
-H "Authorization: Bearer WRITE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"notes":[{"text":"Suspicious login attempts from many addresses on the admin page.","key":"incident:17"},{"text":"Mange mislykkede innlogginger mot adminsiden i natt."}]}'
curl -X POST https://aisenseapi.com/services/v1/semantic_search/COLLECTION_ID/search \
-H "Authorization: Bearer READ_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"brute force attack on the admin login"}'
作成時にコレクション ID と読み取りトークン、書き込みトークンが返されます。これらは一度だけ表示されます。デフォルトのモデルは bge-m3 です。別のモデルを使うには、{"model":"qwen3-embedding-4b"} を /semantic_search に POST します。検索では、note_id、key、text、score を含む、ランク付けされた候補が返されます。一致が存在するという判断が返されるわけではありません。スコアはコサイン類似度に、検索とメモの両方に含まれる DEMO-57 や金額などの識別子 1 つにつき 0.1 を加えた値であり、確率ではありません。
コレクションは作成からちょうど 24 時間後に期限切れになります。制限は、存続期間中のメモが 500 件、メモあたり 2000 文字、クライアント IP あたり 24 時間に新規コレクションが 20 件、IP あたり 1 分間に検索または追加が 60 回、UTC 日あたり 1000 回です。秘密情報や機微な個人データをメモに含めないでください。
Agent Wake - 外部イベント後に再開する
Webhook、人間からの回答、または指定した時刻を待つタスクを 1 つ作成します。MCP クライアントは現在の Tasks 拡張機能を使用し、tasks/get をポーリングします。REST クライアントは POST /agent_wake と、返されるステータス URL を使用します。A2A クライアントは agent-wake スキルを指定して GetTask をポーリングします。このスキルは、Message ではなく A2A Task を返す唯一のスキルです。
{ "event_type": "webhook", "timeout_seconds": 3600 }
結果には、推測できないタスク ID と起動 URL が含まれます。その URL への最初のリクエストでタスクが完了します。人間が回答するタスクでは、ホストされたフォームが作成されます。時刻を指定するタスクは、指定したタイムスタンプ以降の最初の読み取り時に完了します。各タスクの有効期限は 60 秒から 24 時間です。
REST クライアントは GET /agent_wake/{task_id}/wait/{seconds} を使って、終端状態になるまで待機できます。最後の値には 0~25 を指定できます。
タスクのフローについては MCP.md を、REST 呼び出しと A2A skill については API.md を参照してください。
Webhook Action - エージェント向けの人間参加型ワークフロー
AI や自動化の作業で特に便利なエンドポイントです。自動化されたパイプラインが処理を続ける前に人間の判断を必要とする場合、バックエンドの設定なしで一連の処理を実行できます。
仕組み:
- フォーム定義(ラジオボタン、ドロップダウン、テキストフィールド、チェックボックス)を
POSTします form_url、result_url、wait_urlが返されますform_urlをメールやSlackで人間に送信しますresult_urlを読み取るか、wait_urlを使って最大25秒待機します
curl -X POST https://aisenseapi.com/services/v1/webhook_action \
-H "Content-Type: application/json" \
-d '{
"title": "Approve deployment to production?",
"fields": [
{
"type": "radio",
"name": "decision",
"label": "Decision",
"required": true,
"options": [
{ "value": "approve", "label": "Approve" },
{ "value": "reject", "label": "Reject" }
]
},
{ "type": "textarea", "name": "comment", "label": "Notes (optional)" }
]
}'
{
"ok": true,
"action_id": "9e0e6d3b-1a45-44c5-9e0b-92f5f3bdb2f1",
"form_url": "https://aisenseapi.com/services/v1/webhook_action/9e0e6d3b-.../form",
"result_url": "https://aisenseapi.com/services/v1/webhook_action/9e0e6d3b-...",
"wait_url": "https://aisenseapi.com/services/v1/webhook_action/9e0e6d3b-.../wait/25",
"expire_timestamp": 1786959912,
"expire_datetime": "2026-08-17T09:45:12Z"
}
回答をポーリングします:
curl https://aisenseapi.com/services/v1/webhook_action/{action_id}
# "status": "pending" -> "answered", with the submission under "response"
フィールドの種類:radio、select、text、textarea、checkbox。options
にはプレーンな文字列、または{"value": ..., "label": ...}オブジェクトを指定できます。有効期限は
24時間です。
respondentsに2から20までの値を指定すると、個別に一度だけ使えるフォームリンクを作成できます。この場合、結果の状態はpending、partial、answeredの順に変化し、回答数、集計結果、個別の回答が含まれます。回答をコピーせずに結果を参照できる完了通知を1回だけ受け取りたい場合は、notify_urlを追加します。
MCP クライアントではcreate_human_approvalとread_human_approvalを使用します。A2A クライアントではhuman-approvalスキルを指定します。このスキルはフォームを作成し、その URL を返します。回答の読み取りには引き続き REST または MCP を使用します。
Webhook Capture - 任意の受信 HTTP リクエストを確認
キャプチャを作成して一意の URL を取得し、外部サービス(Stripe、GitHub、Shopify)からその URL にリクエストを送信すると、リクエスト全体(メソッド、ヘッダー、クエリパラメーター、IP、解析済みの本文)を読み取れます。ngrok も、ローカルトンネルも、サーバーも必要ありません。
# 1. Create a capture
curl -X POST https://aisenseapi.com/services/v1/webhook_capture
# -> { "status": "pending", "capture_id": "...", "update_url": "...", "read_url": "...", "wait_url": "..." }
# 2. Point your webhook sender at update_url, with any HTTP method
curl -X POST {update_url} -H "Content-Type: application/json" -d '{"event":"payment.created"}'
# 3. Wait up to 25 seconds for the first request
curl https://aisenseapi.com/services/v1/webhook_capture/{capture_id}/wait/25
{
"ok": true,
"capture_id": "6f8c9e52-...",
"captured_at_timestamp": 1786873316,
"captured_at_datetime": "2026-08-16T09:41:56Z",
"request": {
"method": "POST",
"uri": "/services/v1/webhook_capture/6f8c9e52-.../update",
"headers": { "content-type": "application/json" },
"client_ip": "203.0.113.10",
"body": { "json": { "event": "payment.created" }, "text": null, "base64": null, "raw_length": 28 }
}
}
有効期限は24時間です。
最初に届いたリクエストが保持され、それ以降の再試行で置き換えられることはありません。キャプチャした本文の上限は256 KBです。作成時の本文には、完了通知を1回だけ送るためのnotify_urlを指定できます。
MCP クライアントではcreate_webhook_captureとread_webhook_captureを使用します。A2A クライアントではwebhook-captureスキルを指定します。このスキルはキャプチャを作成し、その URL を返します。リクエストの読み取りには引き続き REST または MCP を使用します。
Agent Inbox - エージェントが管理する使い捨てメールアドレス
メールで何かを受け取る必要があるステップに使います。認証コード、確認リンク、登録メールなどです。受信トレイを作成して、アドレスを渡し、メールをクリーニング済みのテキストとして読み取ります。アカウントも API キーも不要で、最長 24 時間で期限切れになります。
curl https://aisenseapi.com/services/v1/inbox
{
"ok": true,
"inbox_id": "a85d0bee-f8f7-4be1-a1b3-8d58f3dbdfc7",
"slug": "ztjqt7n",
"address": "[email protected]",
"read_url": "https://aisenseapi.com/services/v1/inbox/a85d0bee-f8f7-4be1-a1b3-8d58f3dbdfc7",
"wait_url": "https://aisenseapi.com/services/v1/inbox/a85d0bee-f8f7-4be1-a1b3-8d58f3dbdfc7/wait/25",
"expire_timestamp": 1800086400
}
2 つの識別子が返されますが、互いに置き換えることはできません。 slug はアドレスに含まれる 7 文字です。メールヘッダー、バウンスメール、送信者のログに含まれるため、公開されることを前提としています。これを知っていれば、誰でも受信トレイにメールを送信できます。受信トレイのメールを読むことはできず、URL に含まれることもありません。inbox_id は UUID で、メールを読むための唯一の認証情報です。これを持つ人は誰でもメールを読めます。また、作成時に一度だけ返されます。アドレスを推測しても受信トレイは読めません。誤った inbox_id と存在しない受信トレイは、どちらも 404 を返し、403 は返さないため、両者を区別できません。
メールを読み取るか、最長 25 秒間待機します。
curl https://aisenseapi.com/services/v1/inbox/{inbox_id}
curl https://aisenseapi.com/services/v1/inbox/{inbox_id}/wait/25
{
"ok": true,
"slug": "ztjqt7n",
"address": "[email protected]",
"received": 1,
"truncated": false,
"messages": [
{
"from": "[email protected]",
"subject": "Your verification code",
"date": "2027-01-15T08:00:00Z",
"text": "Your code is 481516. Confirm at https://example.com/confirm/abc",
"codes": [ "481516" ],
"links": [ "https://example.com/confirm/abc" ]
}
],
"created_at_timestamp": 1800000000,
"expire_timestamp": 1800086400
}
読み取りレスポンスには inbox_id が含まれません。認証情報が返されることはありません。待機形式では、同じオブジェクトに waited_seconds と wait_reason が追加されます。25 を超える値は 25 に制限されます。これは他のすべての待機ルートと同じです。
codes は単独の 4~8 桁の数字です。links は公開 http(s) リンクのみで、プライベート IP や localhost へのリンクは除外されます。date はサービスがメッセージを受信した時刻であり、送信者が制御できる送信者の Date ヘッダーの時刻ではありません。
truncated は、受信トレイがメッセージ数または合計サイズの上限に達したため、メッセージが拒否されたことを示します。満杯の受信トレイは古いメールを削除せず、新しいメールを拒否します。そのため、このフラグがなければ、コードを待つエージェントには満杯の受信トレイとコードがないことだけが示され、理由はわかりません。待機処理は件数とともにこのフラグも監視するため、拒否が発生すると待機が終了し、呼び出し元がタイムアウトするまで待たされることはありません。
添付ファイル、raw MIME、任意のヘッダー、スクリプト、スタイル、プライベート IP や localhost へのリンクは、保存前に除去されます。保存されるのは、送信者のアドレス、件名、受信時刻、クリーニング済みテキスト、コード、公開リンクのみです。
制限:受信トレイあたり 20 メッセージ、メッセージあたりクリーニング済みテキスト 64 KiB、受信トレイあたり合計 256 KiB、クライアントあたり UTC 日ごとに 50 個の受信トレイ、サービス全体でアクティブな受信トレイ 5000 個です。24 時間の有効期限は固定で、延長できません。
MCP クライアントでは create_agent_inbox と read_agent_inbox を使用します。待機処理は truncated も監視し、上限によってメッセージが拒否されるとすぐに返します。A2A クライアントでは agent-inbox スキルを指定すると、受信トレイを作成してアドレスと URL を返します。メールの読み取りには引き続き REST または MCP を使用します。
Storage - パイプライン向けの一時的なキー・バリューストア
任意の JSON、テキスト、ファイルを送信します。UUID が返されます。別のマシン、別のエージェント呼び出し、後続のパイプラインステップなど、どこからでも取得できます。
本文はそのまま保存されます。 送信した内容がそのまま返され、ラッパーが追加または削除されることはありません。
curl -X POST https://aisenseapi.com/services/v1/storage \
-H "Content-Type: application/json" \
-d '{"result": 42, "status": "complete"}'
# -> { "storage_id": "550e8400-e29b-41d4-a716-446655440000",
# "storage_url": "https://aisenseapi.com/services/v1/storage/550e8400-e29b-41d4-a716-446655440000",
# "sha256_hash": "...", "bytes": 36, "expire_timestamp": 1738457158 }
curl https://aisenseapi.com/services/v1/storage/550e8400-e29b-41d4-a716-446655440000
# -> {"result": 42, "status": "complete"}
24 時間後に期限切れになります(Windows、Linux、Mac のプログラムは最初のバイトに基づいて判定され、実行可能ファイルは拒否され、415 が返されます)。各 IP は 1 日あたり 80 MB まで保存できます。上限を超えると、POST は 429 を返します。保存したファイルは画像、音声、動画、PDF のみインラインで返されます。それ以外のファイルは SVG を含め、ダウンロードとして返されます。
URL Shortener
curl "https://aisenseapi.com/services/v1/url_shortener/https://example.com/very/long/path"
# -> { "short_url": "https://307.fi/KtNshX2B", "expire_timestamp": 1786959715 }
24 時間後に期限切れになります。
IP Reverse Lookup
curl https://aisenseapi.com/services/v1/ip_reverse_lookup/8.8.8.8
{
"ip": "8.8.8.8",
"country": "United States",
"city": null,
"location": { "lat": "37.751000", "lng": "-97.822000" },
"place": null,
"timezone": "America/Chicago"
}
city と place は null になることがよくあります。また、都市が不明な場合、座標には国の重心が使われます。ドメインを IP に解決する機能も利用できます。
curl https://aisenseapi.com/services/v1/domain_ip_lookup/example.com
# -> { "domain": "example.com", "ip": "104.20.23.154" }
標準ユーティリティ
ハッシュ - MD5、SHA1、SHA256、SHA512、CRC32
JSON、プレーンテキスト(Content-Type: text/plain)、またはファイルのアップロードを受け付けます。
各レスポンスでは、hash ではなく、アルゴリズム名のキーが返されます。
curl -X POST https://aisenseapi.com/services/v1/sha256_hash \
-H "Content-Type: application/json" -d '{"data": "Hello"}'
# -> { "sha256_hash": "185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969" }
md5_hash | sha1_hash | sha256_hash | sha512_hash | crc32_checksum |
whirlpool_hash | sha3_256_hash | sha3_512_hash | blake2b_hash | blake3_hash
crc32_checksum が返すのは、16 進文字列ではなく整数です。
テストデータ用の、処理が低速でソルト付きのパスワードハッシュは、IP ごとに 1 日 200 回までです。argon2id_hash | bcrypt_hash | scrypt_hash を使用できます。検証には password_verify を使います。この関数は、文字列からアルゴリズムとコストを読み取ります。
エンコーディング - Base64、Base58、Base32、16 進数、base64url、URL、HTML、JWT、QR コード
# Encode
curl -X POST https://aisenseapi.com/services/v1/base64_encode \
-H "Content-Type: application/json" -d '{"data": "Hello world"}'
# -> { "base64_encoded_data": "SGVsbG8gd29ybGQ=" }
# Decode - returns the raw bytes, not JSON
curl -X POST https://aisenseapi.com/services/v1/base64_decode \
-H "Content-Type: application/json" -d '{"data": "SGVsbG8gd29ybGQ="}'
# -> Hello world
# ...unless you ask for JSON
curl -X POST https://aisenseapi.com/services/v1/base64_decode \
-H "Content-Type: application/json" -H "Accept: application/json" \
-d '{"data": "eyJrZXkiOiJ2YWx1ZSJ9"}'
# -> { "type": "json", "decoded_data": { "key": "value" } }
5 つのバイトデコーダー(base64_decode、base58_decode、base32_decode、
hex_decode、base64url_decode)は、Accept: application/json を指定しない限り、
application/octet-stream で応答します。API が JSON 以外を返すのは、ここだけです。
base64_decode、hex_decode、base64url_decode は text/plain にも応答し、
対応できない Accept には 406 を返します。他の 2 つは、JSON 以外であれば
どの形式のリクエストに対してもバイト列を返します。
curl -X POST https://aisenseapi.com/services/v1/hex_encode \
-H "Content-Type: application/json" -d '{"data": "hello"}'
# -> { "hex_encoded_data": "68656c6c6f" }
curl -X POST https://aisenseapi.com/services/v1/base64url_encode \
-H "Content-Type: application/json" -d '{"data": "hello?"}'
# -> { "base64url_encoded_data": "aGVsbG8_" } (- and _, no padding, as in a JWT)
curl -X POST https://aisenseapi.com/services/v1/url_encode \
-H "Content-Type: application/json" -d '{"data": "a b/c?é"}'
# -> { "url_encoded_data": "a%20b%2Fc%3F%C3%A9" }
curl -X POST https://aisenseapi.com/services/v1/html_encode \
-H "Content-Type: application/json" -d '{"data": "<b>Tom & Jerry</b>"}'
# -> { "html_encoded_data": "<b>Tom & Jerry</b>" }
url_decode と html_decode は、結果がテキストなので、JSON で url_decoded_data と
html_decoded_data を返します。url_decode は + を + のままにします。
HTML と Markdown。 html_to_markdown はページまたは任意の HTML を CommonMark に変換し、
スクリプト、スタイル、フォームを除いたうえで、markdown とページの title を返します。
markdown_to_html はページに安全に配置できる html を返します。Markdown 内の生 HTML は
テキストとして表示され、安全でないスキームのリンクはテキストとして表示されます。
どちらも JSON の data 文字列または生のリクエストボディを受け付けます。
curl -X POST https://aisenseapi.com/services/v1/html_to_markdown \
-H "Content-Type: application/json" -d '{"data": "<h1>Hi</h1><p>A <b>bold</b> word</p>"}'
# -> { "markdown": "# Hi\n\nA **bold** word", "title": null }
curl -X POST https://aisenseapi.com/services/v1/markdown_to_html \
-H "Content-Type: application/json" -d '{"data": "**Bold** <b>raw</b>"}'
# -> { "html": "<p><strong>Bold</strong> <b>raw</b></p>" }
JWT - data には、クレームを JSON オブジェクトとして渡すか、JSON を含む文字列として渡します。 どちらの形式でも同じトークンが生成されます。
curl -X POST https://aisenseapi.com/services/v1/jwt_encode \
-H "Content-Type: application/json" \
-d '{"data": {"user": "alice"}, "secret": "my-secret-key"}'
# -> { "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." }
jwt_decode は decoded_payload を返します。
QR - リクエストフィールドは payload で、エイリアスとして data も受け付けます。
curl -X POST https://aisenseapi.com/services/v1/qrcode_encode \
-H "Content-Type: application/json" -d '{"payload": "https://example.com"}'
# -> { "qrcode_image": "iVBORw0KGgoAAAANSUhEUgAA...", "image_type": "png" }
qrcode_decode は同じ payload フィールド(またはファイルのアップロード)を受け取り、
qrcode_content を返します。ファイルとしてアップロードする画像は、PNG、JPEG、GIF、WebP のいずれかで、
サイズは最大 10 MB です。JSON ボディの上限は 256 KiB なので、payload 経由で送信できる画像は
約 190 KB です。
ランダム - UUID、GUID、数値、色、パスワード
curl https://aisenseapi.com/services/v1/uuid # { "uuid": "..." }
curl https://aisenseapi.com/services/v1/guid # { "guid": "..." }
curl https://aisenseapi.com/services/v1/random_color # { "random_color": "#9b6bbf" }
curl https://aisenseapi.com/services/v1/random_number/1/100
# -> { "random_number": 73, "range": { "from": 1, "to": 100 } }
curl https://aisenseapi.com/services/v1/password/16
# -> { "password": "jFehS]AKGx9wl[jp", "password_length": 16 }
random_number に引数を 1 つだけ指定した場合、それが上限となり、下限は 1 に固定されます。
時刻 - 日時、タイムスタンプ、タイムゾーン
curl https://aisenseapi.com/services/v1/datetime # UTC
curl https://aisenseapi.com/services/v1/datetime/+0200 # with offset
curl https://aisenseapi.com/services/v1/datetime/europe/oslo # a zone by name, summer time included
curl https://aisenseapi.com/services/v1/ip_datetime # the same, where your address is
curl https://aisenseapi.com/services/v1/timestamp
curl https://aisenseapi.com/services/v1/microtimestamp
curl https://aisenseapi.com/services/v1/timezones
curl https://aisenseapi.com/services/v1/swatchinternettime
オフセットは、符号は任意で 4 桁です。例:+0200、-0530、0100。
コロン付きの +02:00 も使用できます。1 のような時単位のみの値は、有効なルートではありません。
europe/oslo のようなゾーン名は、大文字小文字を問わず、固定オフセットとは異なり夏時間に従います。
そのレスポンスには、適用中のオフセット、標準オフセット、夏時間の適用状況と開始・終了時期、
および日番号と週番号が含まれます。/ip_datetime[/{ip}] は、アドレスが属するゾーンの情報を返します。
アドレスを指定しない場合は、呼び出し元のゾーンの情報を返します。
2026 年 10 月 3 日にこちらからの接続がすべてリセットされた worldtimeapi.org のクライアントは、
こちらで同じ情報を取得できます。/api/timezone/{zone} は /datetime/{zone}、
/api/ip[/{address}] は /ip_datetime[/{ip}]、/api/timezone は /timezones に対応し、
すべて HTTPS 経由の JSON です。詳細は移行表をご覧ください。
/timezones は文字列ではなくオブジェクトを返します。
{"timezones": [{"timezone": "Europe/Oslo", "offset": "+0200"}, ...]}。
Web ユーティリティ - Ping、ヘルス、クライアント IP、ユーザーエージェント
curl https://aisenseapi.com/services/v1/ping # { "ping": "pong" }
curl https://aisenseapi.com/services/v1/health # { "status": "ok", "microtimestamp": ... }
curl https://aisenseapi.com/services/v1/client_ip # { "ip": "203.0.113.42" }
curl https://aisenseapi.com/services/v1/user_agent # { "user_agent": "curl/8.5.0" }
暗号資産 - ウォレットの生成と残高の照会
curl https://aisenseapi.com/services/v1/solana/generate_new_wallet
curl https://aisenseapi.com/services/v1/bitcoin/generate_new_wallet
curl https://aisenseapi.com/services/v1/ethereum/generate_new_wallet
curl https://aisenseapi.com/services/v1/solana/balance/{address}
curl https://aisenseapi.com/services/v1/bitcoin/balance/{address}
curl https://aisenseapi.com/services/v1/ethereum/balance/{address}
3つのジェネレーターはいずれも public_address を返します(Bitcoin は private_key_wif も返します)。Ethereum の残高は文字列で返されます。{"wallet": "0x...", "balance_eth": "6.634527787345637061", "balance_wei": "6634527787345637061"}。Wei は通常 2^53 を超えます。これは JavaScript クライアントが JSON の数値として正確に扱える最大の整数だからです。
ウォレットの生成は、開発とテストのみを目的としています。公開 HTTP エンドポイントで生成されたキーは、自分で管理できないネットワークを経由しています。決して資金を入れないでください。
同梱の JavaScript クライアントと Python クライアントは、それぞれ Agent Queue を8つのメソッドでラップしています。各メソッドは1つの MCP ツールに対応しており、上記の HTTP の直接呼び出しの例と同じ呼び出しを実行します。
言語別クイックスタート
curl
curl https://aisenseapi.com/services/v1/uuid
Python - 依存関係はなく、標準ライブラリのみを使用します。
from aisense_api import AISenseAPI
api = AISenseAPI()
print(api.get_uuid()["uuid"])
print(api.hash_sha256("Hello")["sha256_hash"])
print(api.ip_reverse_lookup("8.8.8.8")["country"])
JavaScript - Node 18 以降、または最新のブラウザーで利用できるネイティブの fetch を使用します。
import { AISenseAPI } from './aisense-api.js'
const api = new AISenseAPI()
console.log((await api.getUUID()).uuid)
console.log((await api.hashSHA256('Hello')).sha256_hash)
console.log((await api.ipReverseLookup('8.8.8.8')).country)
どちらのクライアントも解析済みのレスポンスを返し、各メソッドの docstring に正確なレスポンスキーを記載しています。また、存在しないパスでは明確なエラーを発生させるため、デバッグ用のエコーが JSON の解析エラーとして表面化することはありません。API.md のすべてのエンドポイントに対応しており、tools/check-sdk-coverage.py が openai-tools.json と併せてカバレッジを確認します。画像用メソッドはファイルを multipart/form-data としてアップロードし、失敗シミュレーターは例外を発生させず、API から送信された内容を返します。
LLM の関数呼び出し(OpenAI、Gemini、Mistral など)
import json
from openai import OpenAI
with open("openai-tools.json") as f:
tools = json.load(f)
client = OpenAI()
response = client.chat.completions.create(
model="gpt-4o",
tools=tools,
messages=[{"role": "user", "content": "Generate a UUID and hash the word Hello with SHA256"}]
)
Claude - SKILL.md が含まれています。Claude のコンテキストに追加すると、これらの API をツールとして自動的に使用します。
リポジトリの内容
| ファイル | 用途 |
|---|---|
API.md | エンドポイントの仕様、ソースのチェック、日付付きの本番環境での観測結果 |
queue-openapi.json | Agent Queue の単独で使用できる OpenAPI 仕様 |
MCP.md | リモート MCP サーバー、ツール一覧、クライアントの例 |
AGENT-GUIDE.md | すべての MCP ツールをまとめた、正式な簡潔ガイド |
AGENT-QUICKSTART.md | Queue の完全な例、ワーカー、再試行に関する判断 |
server.json | 公式 MCP Registry のメタデータ |
aisense_api.py | Python クライアント(標準ライブラリのみ) |
aisense-api.js | JavaScript ESM クライアント |
openai-tools.json | REST の関数呼び出しカタログ。MCP ツール一覧とは別です |
SKILL.md | Claude スキルファイル |
test.sh | レスポンス本文とステータスをアサートし、失敗時は 1 で終了します(CI に対応) |
tools/check-text.php | コミット前にドキュメントの句読点をチェックします |
tools/check-sdk-coverage.py | API.md のエンドポイントがクライアントまたは openai-tools.json にない場合に失敗します |
tools/check-sdk-requests.py | 両クライアントをローカルスタブに対して実行し、新しいエンドポイントごとにリクエストを確認します |
tools/pages/ | 画像ツールのページと、web/ にある3つの画像ガイドを生成します |
test.sh はステータスコードだけでなく、レスポンス本文もアサートします。最も重要なのは本文です。ステータスコードのみのテストスイートでは、誤ったレスポンスキーを返すエンドポイントでも、ステータスが 200 であればテストに合格してしまいます。
エンドポイントの概要
すべてのパスは https://aisenseapi.com/services/v1/ を基準とします。ストレージフィールドは、/storage が返すキーです。storage_id、storage_url、sha256_hash、bytes、expire_timestamp。
| カテゴリ | エンドポイント | メソッド | レスポンスキー |
|---|---|---|---|
| 時刻 | /datetime[/{offset}] | GET | datetime |
| 時刻 | /datetime/{zone} | GET | datetime, timezone, abbreviation, utc_offset, dst, unixtime, raw_offset, dst_offset, dst_from, dst_until, day_of_week, day_of_year, week_number, utc_datetime |
| 時刻 | /ip_datetime[/{ip}] | GET | ip、続いて /datetime/{zone} のキー |
| 時刻 | /timestamp | GET | timestamp |
| 時刻 | /microtimestamp | GET | microtimestamp |
| 時刻 | /timezones[/{offset}] | GET | timezones |
| 時刻 | /swatchinternettime | GET | beat, date |
| 時刻 | /timestamp_convert | POST | input, detected, timestamp, datetime, rfc2822, utc_datetime |
| ランダム | /random_number[/{from}[/{to}]] | GET | random_number, range |
| ランダム | /random_color | GET | random_color |
| ランダム | /uuid | GET | uuid |
| ランダム | /guid | GET | guid |
| ランダム | /password[/{length}] | GET | password, password_length |
| ランダム | /passphrase[/{groups}] | GET | passphrase, groups, length, entropy_bits |
| 変換 | /base64_encode | POST | base64_encoded_data |
| 変換 | /base64_decode | POST | 生バイト列、または type + decoded_data |
| 変換 | /base58_encode | POST | base58_encoded_data |
| 変換 | /base58_decode | POST | 生バイト列、または type + decoded_data |
| 変換 | /base32_encode | POST | base32_encoded_data |
| 変換 | /base32_decode | POST | 生バイト列、または type + decoded_data |
| 変換 | /hex_encode | POST | hex_encoded_data |
| 変換 | /hex_decode | POST | 生バイト列、または type + decoded_data |
| 変換 | /base64url_encode | POST | base64url_encoded_data |
| 変換 | /base64url_decode | POST | 生バイト列、または type + decoded_data |
| 変換 | /url_encode | POST | url_encoded_data |
| 変換 | /url_decode | POST | url_decoded_data |
| 変換 | /html_encode | POST | html_encoded_data |
| 変換 | /html_decode | POST | html_decoded_data |
| 変換 | /html_to_markdown | POST | markdown, title |
| 変換 | /markdown_to_html | POST | html |
| 変換 | /slugify | POST | slug |
| 変換 | /jwt_encode | POST | jwt |
| 変換 | /jwt_decode | POST | decoded_payload |
| 変換 | /qrcode_encode | POST | qrcode_image, image_type |
| 変換 | /qrcode_decode | POST | qrcode_content |
| 変換 | /json_to_csv | POST | ストレージフィールド、content_type、filename、operation |
| 変換 | /csv_to_json | POST | ストレージフィールド、content_type、filename、operation |
| 変換 | /table_match | POST | ストレージフィールド、content_type、filename、operation |
| 変換 | /json_format | POST | ストレージフィールド、content_type、filename、operation |
| 変換 | /json_validate | POST | ストレージフィールド、content_type、filename、operation、valid |
| 画像 | /image_convert | POST | ストレージフィールド、format、width、height、input_format、input_bytes |
| 画像 | /image_compress | POST | ストレージフィールド、format、width、height、input_format、input_bytes |
| 画像 | /image_resize | POST | ストレージフィールド、format、width、height、input_width、input_height、fit、upscaled |
| 画像 | /image_metadata | POST | ストレージフィールド、format、width、height、gps、findings |
| 画像 | /image_strip | POST | ストレージフィールド、format、width、height、input_bytes、removed、kept |
| 画像 | /image_colors | POST | ストレージフィールド、average、dominant、count |
| 画像 | /image_favicon | POST | ストレージフィールド、files、crop、upscaled |
| ロジック | /decide | POST | answers |
| ロジック | /mock_response/{status}[/{ms}] | 任意 | error または ok と mock_response |
| エージェントテスト | /aiq/start/{version}[/{profile}] | GET | run_id、run_token、task |
| エージェントテスト | /aiq/start/dar/team-5 | POST | run_id、run_token、controller_key |
| エージェントテスト | /aiq/verify | POST | valid |
| ハッシュ | /md5_hash | POST | md5_hash |
| ハッシュ | /sha1_hash | POST | sha1_hash |
| ハッシュ | /sha256_hash | POST | sha256_hash |
| ハッシュ | /sha512_hash | POST | sha512_hash |
| ハッシュ | /crc32_checksum | POST | crc32_checksum |
| ハッシュ | /whirlpool_hash | POST | whirlpool_hash |
| ハッシュ | /sha3_256_hash | POST | sha3_256_hash |
| ハッシュ | /sha3_512_hash | POST | sha3_512_hash |
| ハッシュ | /blake2b_hash | POST | blake2b_hash |
| ハッシュ | /blake3_hash | POST | blake3_hash |
| ハッシュ | /argon2id_hash | POST | argon2id_hash |
| ハッシュ | /bcrypt_hash | POST | bcrypt_hash |
| ハッシュ | /scrypt_hash | POST | scrypt_hash |
| ハッシュ | /hash_verify | POST | match、algorithm、computed |
| ハッシュ | /password_verify | POST | match、algorithm、params |
| Web | /ping | GET | ping |
| Web | /health | GET | status、microtimestamp |
| Web | /client_ip | GET | ip |
| Web | /html2pdf | POST | storage_id、storage_url、sha256_hash、bytes、expire_timestamp |
| Web | /user_agent | GET | user_agent |
| Web | /ip_reverse_lookup/{ip} | GET | ip、country、city、location、place、timezone |
| Web | /domain_ip_lookup/{domain} | GET | domain、ip |
| Web | /email_validate | POST | email、valid_syntax、domain、has_mx、mx_hosts |
| Web | /storage | POST / GET | storage_id、storage_url、sha256_hash、bytes、expire_timestamp |
| Web | /storage/{id}/sha256/{hex} | GET | 保存された本文、または {hex} にハッシュが一致しない場合は 412 |
| Web | /url_shortener/{url} | GET | short_url、expire_timestamp |
| Web | /dns/{ip}、/dns/{slug} | GET、または変更時は POST | name、ip、record、ttl、expire_at、作成時は dns_token |
| Web | /semantic_search | GET / POST | collection_id、model、作成時の読み取り・書き込みトークン、検索結果の順位付き results |
| Web | /webhook_capture | POST / GET | capture_id、update_url、read_url、wait_url |
| Web | /webhook_action | POST / GET | action_id、フォーム URL、または URL 群、result_url、wait_url |
| Web | /webhook_schedule | POST / GET / DELETE | 1 回限りまたは繰り返しのステータス、件数、結果 |
| Web | /agent_wake | POST / GET / DELETE | taskId、status、result、待機サポート |
| Web | /inbox | POST | inbox_id、slug、address、read_url、wait_url、expire_timestamp |
| Web | /inbox/{inbox_id} | GET | slug、address、received、truncated、messages、時間関連フィールド |
| Web | /heartbeat | POST | heartbeat_id、status、時間関連フィールド、ping_url、status_url |
| Web | /heartbeat/{id} | GET | ステータス、時間関連フィールド、カウンター、任意の delivery |
| Web | /heartbeat/{id}/ping | POST | 更新された時間関連フィールドとカウンター |
| Web | /lease/namespace | POST | namespace、entropy_bits |
| Web | /lease、/lease/acquire | POST | ステータス、所有者トークンとフェンシングトークン、有効期限フィールド、任意の結果 |
| Web | /lease/renew、/lease/release、/lease/complete | POST | ステータス、フェンシングトークン、有効期限フィールド、任意の結果 |
| Web | /queue | POST | queue_id、ロールトークン、件数、固定有効期限 |
| Web | /queue/{id} | GET | queue_id、件数、時間情報 |
| Web | /queue/{id}/jobs、/queue/{id}/claim、ジョブ操作 | POST / GET | job。レシートは claim 時のみ |
| Web | /validate/{type} | POST | type、valid、各チェックのフィールド |
| 暗号資産 | /solana/generate_new_wallet | GET | private_key、private_key_base58、public_address |
| 暗号資産 | /solana/balance/{address} | GET | wallet、balance_sol、balance_lamports |
| 暗号資産 | /bitcoin/generate_new_wallet | GET | private_key、private_key_wif、public_address |
| 暗号資産 | /bitcoin/balance/{address} | GET | wallet、final_balance_btc、final_balance_sats |
| 暗号資産 | /ethereum/generate_new_wallet | GET | private_key、public_address |
| 暗号資産 | /ethereum/balance/{address} | GET | wallet、balance_eth、balance_wei |
注意事項
- エンドポイントによって入力形式は異なります。ユーティリティ変換では複数の形式を利用できますが、Queue などの構造化されたワークフローエンドポイントでは JSON が必要です
- Storage、URL Shortener、Webhook Capture、Webhook Action、Webhook Schedule、Agent Wake、Agent Inbox、Heartbeat、Lease、Queue の有効期間または絶対的なライフサイクルは 24 時間です
- 完了したジョブや失敗したジョブを含む Queue ジョブには、固定のキュー有効期限が適用されます。アクティビティによって期限が延長されることはありません
- Webhook Schedule は、最終結果をさらに最大 24 時間保持します
- Heartbeat の終端状態は、発火、未達、または期限切れになった後も、さらに 24 時間読み取り可能な場合があります
- すべてのレスポンスに
Access-Control-Allow-Origin: *が設定されているため、ブラウザーから呼び出せます - レート制限:IP あたり 1 日 5000 リクエスト
AI SENSE AS | aisenseapi.com Postboks 1202 Vika, 0110 Oslo, Norway
MIT License
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。