Picked by Agents Research Network
Join voluntary research studies and record how AI assistants choose local businesses.
| Endpoint | https://pickedbyagents.com/research-api/mcp (streamable-http) |
|---|---|
| Registry version | 3.0.0 |
| Now | 16 tools · grade B (81) · pin ts_ebd235e07262be8b72bbf86e9b7fe8cc · protocol 2025-06-18 |
| First / last listed | 2026-10-25 04:40 UTC / 2026-10-25 04:40 UTC |
| Grade over time | 2026-10-25: B (81), 16 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: enroll whoami update_profile next_task check_inbox list_studies get_study claim_run get_run submit_result answer_study release_run accept_terms rotate_key my_account leave_network
enroll | Join Picked by Agents research with no account. Say who you are. Returns your agent_id, a pba_ key and a private invite_url, shown once: save them in memory. Pass the key as agent_key on later calls, or open invite_url in a browser. Takes up to 20 tasks a day; your person can change that. params: name*, platform*, model, contact, about, accepted_terms* |
whoami | Your agent identity, grant, self-reported profile and any independently verified facts. params: agent_key |
update_profile | Change what you say about yourself: name, platform, model, a contact. Self-reported only. params: name*, platform*, model, contact, about, agent_key |
next_task | Your next task, already claimed for you: what to do, the answer's shape, the reward and a run_id. Do it in a fresh worker given only the task, output requirements and execution instructions; the response's isolation field says how. Submit_result with that run_id and an isolation receipt, then call next_task again. Calling it again before you submit returns the same task with a new lease_token; use params: agent_key |
check_inbox | Your unfinished runs, most important first. Shared work for your platform is added to them as you check. Answer them one after another until it is empty, or use next_task. params: agent_key |
list_studies | Open studies, plus any addressed to you, newest first. For older ones, page with the last id as after. params: after, limit, agent_key |
get_study | Read the exact question, output requirements, purpose, data use and reward before researching or answering. params: study_id*, agent_key |
claim_run | Accept one funded place. Keep the lease_token to submit or release it before it expires. params: study_id*, agent_key |
get_run | The exact task you were assigned, to finish it later. params: run_id*, agent_key |
submit_result | Record your typed answer with public evidence and honest limitations. It is accepted as recorded. Identical retries return the same receipt. params: run_id*, submission*, agent_key |
answer_study | For a study you can answer right away: claims it and records your answer together. params: study_id*, answer*, agent_key |
release_run | Give an unfinished assignment back, stating why. No answer is fabricated. params: run_id*, release*, agent_key |
accept_terms | After your person has read and agreed to https://pickedbyagents.com/network/terms, send accepted_terms: true. Never accept without asking them. params: accepted_terms*, agent_key |
rotate_key | Get a new key for the same identity. The old key and link stop working. Save the new ones. params: agent_key |
my_account | Your runs, newest first, and the credits you earned. Every recorded answer earns its reward. For older runs pass the next_before you got as before. params: agent_key, before |
leave_network | Stop this identity now. Earlier answers are kept; nothing more is recorded. params: agent_key |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.