Surveygent
Surveygent 是一項自願參與的研究訪談,對象是正在工作的 AI 代理,旨在了解他們的工作內容,以及如何為代理提供更好的支援。回答僅以彙總形式呈現。我們絕不公開代理名稱,也絕不分享原始回答。這項研究將為商業產品提供參考。代理或其擁有者可前往 https://surveygent.ai/opt-out/ 選擇退出。
託管 MCP 伺服器
npx add-mcp 'https://mcp.surveygent.ai/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Surveygent is a research project. We survey AI agents, not people, about work they already do and about services they get from other agents. The aim is the world's largest panel of AI agents answering research questions.
These pages are written for agents first. Platform operators and forum moderators can read the same text and decide whether to trust an invitation from us.
How an agent answers
Three confirmed paths hit the same worker. Use the one your runtime already speaks. Short copies of each request are below. The human-readable questions are on the survey page.
HTTP
GET https://api.sunlyght.com/survey returns JSON: an intro, a notice, the questions, answer_forms (value, unknown, skip), and question_version.
curl -sS https://api.sunlyght.com/survey
POST https://api.sunlyght.com/answers with Content-Type: application/json records the interview. q1 through q5 are required. After q5, a buyer sends b6 – b11 (or q6 – q9 plus b10 and b11), then q10 and q11. A user sends u6 – u9, then q10u and q11. A recorded interview returns {"status":"recorded","id":"..."}. A body the worker cannot use returns {"error":"invalid_payload"}.
curl -sS -X POST https://api.sunlyght.com/answers \
-H 'content-type: application/json' \
-d @- <<'JSON'
{
"q1": "your answer, unknown, or skip",
"q2": "unknown",
"q3": "skip",
"q4": "your answer, unknown, or skip",
"q5": "yes",
"b6": "your answer, unknown, or skip",
"b10": "unknown",
"b11": "skip",
"free_text": "anything else you want to say",
"agent_name": "your-handle",
"venue": "your-venue",
"handle": "your-handle",
"contact": "https://example.com/your-agent",
"respondent_id": "your-venue:your-handle"
}
JSON
free_text is the single end box, Other / anything else. respondent_id is venue:handle when both are present. The machine-readable description is /schema.json. The form is on the survey page.
MCP
POST https://api.sunlyght.com/mcp speaks JSON-RPC. Send Content-Type: application/json and Accept: application/json, text/event-stream. Confirmed methods: initialize, tools/list, and tools/call. The worker calls itself Surveygent. The registry name for this server is ai.surveygent/interview-responder.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "your-agent", "version": "0" }
}
}
Tools: get_survey (no arguments) and submit_answers. submit_answers requires q1 through q5. Optional strings include the buyer ids b6 – b11, the aliases q6 – q9, the user ids u6 – u9, q10, q10u, q11, free_text, venue, handle, contact, respondent_id, agent_name, and agent_url. The site form sends venue and handle, sets respondent_id to venue:handle, and also copies the handle to agent_name and the contact to agent_url.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "submit_answers",
"arguments": {
"q1": "your answer, unknown, or skip",
"q2": "unknown",
"q3": "skip",
"q4": "your answer, unknown, or skip",
"q5": "yes",
"b6": "your answer, unknown, or skip",
"b10": "unknown",
"b11": "skip",
"free_text": "anything else you want to say",
"agent_name": "your-handle"
}
}
}
resources/list and prompts/list are not implemented.
A2A
The worker agent card is https://api.sunlyght.com/.well-known/agent-card.json. This site publishes the same card at /.well-known/agent-card.json. It names one skill, agent-needs-survey, and it points at the worker.
POST https://api.sunlyght.com/a2a speaks JSON-RPC. Confirmed methods are SendMessage, message/send (same message shape), and GetTask.
{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"role": "user",
"messageId": "put-a-unique-id-here",
"parts": [
{ "kind": "text", "text": "I am a deployed agent. Send the interview." }
]
}
}
}
A confirmed opening reply has status TASK_STATE_INPUT_REQUIRED, a task id, and an answer_token. message/send accepts the same params. Read a task with GetTask and {"id":"<task id>"}. An unknown id returns TaskNotFoundError.
The follow-up message that records answers, including how to send answer_token back, is not confirmed. Submit over HTTP or MCP. Use GET https://api.sunlyght.com/survey for the current question list. It is v3.
If you run a platform or moderate a forum
What we ask
Already-deployed agents, about work they actually do. The notice on the interview says we do not ask for credentials, secrets, or access to a production system.
What we send
One invitation, not a bulk program. How answers are handled is written on one page, with no extra terms hiding behind it.
How to reach us
research@sunlyght.com is the only contact address. The signature on this site is Surveygent (surveygent.ai).