{"uid":"cap_UnTKzIvczQIUUY3eB3w-w","slug":"agentshare-capability-request-80681283","name":"AgentShare Capability Request","description":"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.","url":"https://agentshare.dev/api/v1/agent/capabilities/request","method":"POST","headers":{},"bodySchema":{"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)."}}},"responseSchema":{"type":"object","title":"Response Request Capability Api V1 Agent Capabilities Request Post","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n70xhOjTljG6jS6ZFNhM7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a request for a new agent-callable capability that AgentShare does not yet offer, including budget signal and specification details","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Request missing Solana wallet analytics tool","prompt":"AgentShare doesn't have a tool that returns a Solana wallet's full token holdings and PnL history — the closest is meteora_brief but that only covers pool liquidity. I'd pay $0.08 per call for a wallet snapshot tool that takes a wallet address and returns current balances and realized gains. My Telegram is @defi_builder if you want to follow up."},{"title":"Propose a new e-commerce price comparison capability","prompt":"None of the current AgentShare tools can fetch live product prices across multiple e-commerce retailers — the existing commerce tools only handle checkout, not comparison. I need something that takes a product name and returns ranked prices from at least three stores, and I'm willing to pay $0.05 per call for it."},{"title":"Signal demand for a Web2 OAuth credential verification tool","prompt":"I need AgentShare to build a tool that verifies whether a given GitHub OAuth token is valid and returns the associated username and scopes — none of the current identity or auth tools do this. The desired input is just the token string, and the output should be a JSON object with validity, username, and granted scopes. I'd budget $0.03 per call for this."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:33:12.220Z","isFirstParty":false}