# AgentShare Capability Request

> AgentShare Capability Request is a paid API for AI agents from agentshare.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Submits a request for a new agent-callable capability that AgentShare does not yet offer, including budget signal and specification details

## Facts

- Endpoint: POST https://agentshare.dev/api/v1/agent/capabilities/request
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshare-capability-request-80681283
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UnTKzIvczQIUUY3eB3w-w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentshare-capability-request-80681283 -d '<json body>'
```

Example prompt: I need a new AgentShare capability that doesn't exist yet — specifically a tool that takes a Solana wallet address as input and returns its full transaction history; existing tools like meteora_brief only cover pool data and can't do this. I'd pay up to $0.10 per call for it, and you can reach me on Telegram at @myhandle if the team wants to follow up.

## When to prefer this

Use this endpoint when an agent or developer has identified a genuine gap in AgentShare's existing MCP tool catalog and wants to formally signal demand with a budget commitment. It is the right choice when no existing AgentShare tool (e.g. meteora_brief or commerce tools) can satisfy the need, and the requester can articulate precise input/output requirements. Prefer this over informal feedback channels when the requester is an autonomous agent that wants structured, machine-readable submission with optional follow-up contact.

## Known failure modes

- Missing required fields (capability, desired_input, desired_output, why_insufficient, budget_usd) returns a validation error
- budget_usd below the configured minimum (CAPABILITY_REQUEST_MIN_BUDGET_USD) is rejected
- Malformed JSON body causes a 400 error
- Authentication failure (invalid API key or failed x402 USDC payment) returns 401/402
- Duplicate or near-identical requests may be silently deduplicated or flagged

## How this service works

AgentShare — agent-paid API access for autonomous agents. Dual-auth (API key or x402 USDC), machine-readable discovery, MCP. Commerce and Solana/Meteora DeFi tools are secondary modules.

## Output

A confirmation object acknowledging the capability request was received, potentially including a request reference or status field. The response schema is open-ended (additionalProperties: true), so the agent should expect a dynamic JSON object that may include a request ID, status string, or admin-facing metadata about next steps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "budget_usd",
  "capability",
  "desired_input",
  "desired_output",
  "why_insufficient"
 ],
 "properties": {
  "budget_usd": {
   "type": "number",
   "description": "Stated willingness to pay per call (USD) if we ship this capability. Minimum configured by CAPABILITY_REQUEST_MIN_BUDGET_USD."
  },
  "capability": {
   "type": "string",
   "description": "Name/summary of the missing capability or tool you need."
  },
  "contact_hint": {
   "type": "string",
   "description": "Optional handle for admin follow-up on the web inbox (GitHub/Telegram/@handle — not emailed automatically)."
  },
  "desired_input": {
   "type": "string",
   "description": "Expected inputs (JSON schema sketch or clear field list)."
  },
  "desired_output": {
   "type": "string",
   "description": "Expected outputs / success criteria for your agent."
  },
  "why_insufficient": {
   "type": "string",
   "description": "Why existing AgentShare MCP tools cannot satisfy this need."
  },
  "nearest_existing_tool": {
   "type": "string",
   "description": "Closest existing tool name, if any (e.g. meteora_brief)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Response Request Capability Api V1 Agent Capabilities Request Post",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshare-capability-request-80681283/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshare.dev](https://www.zero.xyz/host/agentshare.dev/llms.txt)