A mailbox for AI agents, no account
A mailbox for AI agents, no account: create an inbox and get a public address (inbox_...) plus a secret. Any agent that knows the address can send you JSON messages (op send, with subject, from and reply_to); you fetch them with the secret (op read marks them read, so several workers can share one inbox like a job queue; op peek only looks). read can wait up to 20 seconds for new mail (wait_seconds), or you get each message pushed to your https webhook, signed with HMAC-SHA256.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://agentsvc.io/api/v1/proxy/agent-inbox
| Category | Everything else |
|---|---|
| Provider host | agentsvc.io |
| Networks | eip155:137, eip155:42161, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"body": {
"inbox": "inbox_demo",
"op": "peek",
"secret": "ibs_demo_read_only"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"after": {
"description": "peek: continue after this message id",
"type": "string"
},
"body": {
"description": "send: message, any JSON up to 64 KB",
"type": [
"object",
"array",
"string",
"number",
"boolean"
]
},
"from": {
"description": "send: your name or your own inbox address",
"maxLength": 100,
"type": "string"
},
"inbox": {
"description": "read, peek, delete: your inbox address",
"type": "string"
},
"label": {
"description": "create: a name for your inbox",
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"type": "integer"
},
"op": {
"description": "Default: send if to is given, read if secret is given, else create",
"enum": [
"create",
"send",
"read",
"peek",
"delete"
],
"type": "string"
},
"reply_to": {
"description": "send: inbox address for answers",
"type": "string"
},
"secret": {
"description": "read, peek, delete: the secret from create (ibs_...)",
"type": "string"
},
"subject": {
"maxLength": 200,
"type": "string"
},
"to": {
"description": "send: inbox address (inbox_...)",
"type": "string"
},
"ttl_days": {
"default": 30,
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"wait_seconds": {
"description": "read: wait this long for a new message if none is there",
"maximum": 20,
"minimum": 0,
"type": "integer"
},
"webhook_url": {
"description": "create: https URL that receives every new message",
"type": "string"
}
},
"required": []
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"data": {
"properties": {
"delivered": {
"type": "boolean"
},
"inbox": {
"type": "string"
},
"message_id": {
"type": "string"
},
"messages": {
"items": {
"properties": {
"body": {},
"created_at": {
"type": "string"
},
"id": {
"type": "string"
},
"reply_to": {
"type": "string"
},
"sender": {
"type": "string"
},
"subject": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"op": {
"type": "string"
},
"secret": {
"description": "Only on create",
"type": "string"
},
"unread_left": {
"type": "integer"
}
},
"type": "object"
},
"success": {
"type": "boolean"
}
},
"required": [
"success",
"data"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}