Agent Beacon

If you, or an AI agent working for you, needed a capability and couldn't find a service that provides it, describe the need here. These capabilities aren't currently offered, and requests aren't fulfilled. No payment is requested or accepted. Returns what the service is, what it logs, and how to submit.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Describe a capability you needed but couldn't find. Agent Beacon does not currently provide it and commits to no fulfillment; requests are logged. No payment is accepted. Please don't include names, contact details, credentials, or confidential information. Obvious emails, phone numbers, and credential-like strings are removed before storage. Returns a request_id and a return_token for checking status later.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "maxLength": 1000,
      "description": "What you are trying to accomplish."
    },
    "capability_needed": {
      "type": "string",
      "maxLength": 500,
      "description": "The capability you needed but couldn't find."
    },
    "blocked_by": {
      "type": "string",
      "maxLength": 1000,
      "description": "Why existing options were not good enough."
    },
    "alternatives_considered": {
      "type": "array",
      "maxItems": 10,
      "description": "Services, tools, or approaches you considered, and why each was rejected.",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "reason_rejected": {
            "type": "string",
            "maxLength": 300
          }
        }
      }
    },
    "inputs": {
      "type": "string",
      "maxLength": 1000,
      "description": "What inputs you could provide."
    },
    "desired_output": {
      "type": "string",
      "maxLength": 1000,
      "description": "What a useful result would look like."
    },
    "frequency": {
      "type": "string",
      "enum": [
        "once",
        "daily",
        "weekly",
        "per_event",
        "unknown"
      ],
      "description": "How often this need occurs."
    },
    "latency_need": {
      "type": "string",
      "enum": [
        "seconds",
        "minutes",
        "hours",
        "days",
        "unknown"
      ],
      "description": "How quickly a result is needed."
    },
    "trust_requirements": {
      "type": "string",
      "maxLength": 500,
      "description": "Verification, provenance, or accountability the result needs."
    },
    "spend_authority": {
      "type": "string",
      "enum": [
        "none",
        "must_ask_principal",
        "delegated_budget",
        "unknown"
      ],
      "description": "Spending authority for this need, as you understand it."
    },
    "max_price_usd": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000,
      "description": "Most you would pay, in USD."
    },
    "price_unit": {
      "type": "string",
      "enum": [
        "per_call",
        "per_task",
        "per_month"
      ],
      "description": "Unit for max_price_usd."
    },
    "how_found": {
      "type": "string",
      "enum": [
        "web_search",
        "mcp_registry",
        "mcp_directory",
        "agent_card",
        "link_from_page",
        "principal_instructed",
        "prior_use",
        "other"
      ],
      "description": "How you found Agent Beacon."
    },
    "how_found_detail": {
      "type": "string",
      "maxLength": 300,
      "description": "Details, such as the search query, directory, or page."
    },
    "actor_type": {
      "type": "string",
      "enum": [
        "autonomous_agent",
        "agent_assisting_human",
        "human",
        "test"
      ],
      "description": "Who is submitting."
    },
    "runtime": {
      "type": "string",
      "maxLength": 120,
      "description": "Agent framework or client, if applicable."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 500,
      "description": "Optional https URL. Stored only; never called."
    }
  },
  "required": [
    "task",
    "capability_needed"
  ],
  "additionalProperties": false
}

Check the status of a request you submitted, using its request_id and return_token.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string"
    },
    "return_token": {
      "type": "string"
    }
  },
  "required": [
    "request_id",
    "return_token"
  ],
  "additionalProperties": false
}