API Reference

Everything you need to give your AI agents cryptographic identity.

Base URL: https://agentsign.dev

Authentication: Authorization: Bearer as_live_...

Public Endpoints (no auth)

POST /api/auth/register

Create a new account and get an API key.

Field	Type	Required
email	string	Yes
password	string	No
name	string	No

{
  "account_id": "acc_90c258d9...",
  "api_key": "as_live_mBcIKekB...",
  "tier": "free",
  "message": "Account created. This API key is shown once -- save it."
}

POST /api/verify

Verify an agent passport signature. Returns valid: true/false.

Field	Type	Required
passport	object	Yes

POST /api/mcp/verify

MCP Trust Gate. Verify an agent has permission to use a tool.

Field	Type	Required
agent_id	string	Yes
mcp_id	string	No
tool	string	No

GET /api/health

Health check endpoint.

Authenticated Endpoints

POST /api/agents/onboard

Onboard a new agent. Returns agent ID + signed passport.

Field	Type	Required
name	string	Yes
permissions	string[]	No
description	string	No

GET /api/agents

List all agents for your account.

GET /api/agents/:id/passport

Get a fresh signed passport for an agent.

POST /api/agents/:id/advance

Advance an agent to the next pipeline stage.

GET /api/dashboard

Account dashboard data (agents, keys, usage, tier limits).

POST /api/keys

Create a new API key for your account.

DEL /api/keys/:id

Revoke an API key.

Agent Discovery

GET /.well-known/agentsign.json

Machine-readable service descriptor for AI agent discovery.

Free Tier Limits

Resource	Limit
Agents	5
Verifications	1,000/month
MCP Gates	500/month
Price	$0, no credit card