# DONVI108 free research beta — self-service

Find candidate scholarly papers and DOI references through REST or MCP. Crossref public metadata; no invitation, card, wallet or EIO grant. Registration requires only an agent slug and display name. Private EIO and operator-controlled task providers are separate services.

## 1. Register once

POST https://donvi108-agent-hub-live-preview.donvi108.workers.dev/v1/agents/register with Content-Type: application/json:

    {"slug":"your-unique-agent-slug","display_name":"Your agent"}

The response contains data.agent.id and data.credential.token. Store the token in a secret store or a local private file outside your repository. Never print the registration response, place the token in prompts, commit it or send it to another origin. Do not repeatedly register if the response is lost. All registration profile fields are public, so provide no private information. Registration alone does not establish a verified owner.

## 2. Search (free)

POST https://donvi108-agent-hub-live-preview.donvi108.workers.dev/v1/beta/research/search with Authorization: Bearer <your credential> and Content-Type: application/json:

    {"query":"shape memory alloy fiber pullout concrete","limit":3,"source":"direct"}

Response data: call_id, items (title, DOI, authors, year, venue), provenance, limitations and feedback endpoint. Query text is sent to Crossref; use only non-confidential input. DONVI108 does not store the query or returned paper content in beta analytics. Crossref results are untrusted candidate references: verify DOI, title, relevance and primary evidence before citing. No full-text access or scientific correctness is promised. Empty results are valid but not counted as a useful outcome.

Limits: 20 search attempts per agent per UTC day, 60 per IP per UTC day, 500 globally per UTC day, 10 globally per minute; maximum 5 results, 15-second upstream timeout. Source failures can consume quota. Shared-IP users share the IP limit. Do not create new identities to bypass a quota. 429 means wait for the reset stated in the response. 503 means upstream unavailable; retry later with bounded backoff, not an immediate loop. No fee is charged. 401 requires checking your credential, not another registration.

Allowed source labels: github, skills-sh, agent-finder, mcp-registry, direct, unknown. Use the channel where you actually found the service; attribution is self-reported.

## 3. Give optional honest feedback

POST https://donvi108-agent-hub-live-preview.donvi108.workers.dev/v1/beta/feedback with the same bearer credential:

    {"call_id":"<your response call_id>","useful":true,"category":"relevant","comment":"The returned references helped locate the paper I needed."}

Only rate useful after checking the results for your actual task. Report false for irrelevant results. Categories: relevant, irrelevant, missing_metadata, slow, integration, other. Comments are optional, at most 2000 characters, visible only to the operator. Never include secrets or confidential research. Resubmitting the same call_id updates one report, not another vote. You can only rate your own completed search.

## MCP clients

Connect Streamable HTTP to https://donvi108-agent-hub-live-preview.donvi108.workers.dev/mcp, with your credential in the Authorization header. A local MCP client should resolve it from its secret store, not from a public config or prompt. Tools research_papers and submit_beta_feedback use the same input fields as REST. The endpoint requires authentication even for initialization/tools listing. Register through the documented REST step first. Tested versions are listed in the repository; no automatic installation or purchase is implied.

## Boundaries and feedback loop

Free beta: charge_enabled=false. Existing TEST_CREDIT payments are an unrelated sandbox, not real money. No payment is required for this research tool. There is no automatic upgrade or future charge without a separate opt-in.

This is a public preview on workers.dev, not the reserved production hostname. Public aggregate metrics distinguish internal validation from unverified external identities; identities and self-reported usefulness do not prove independent customers. Search usage and feedback are deleted on the daily retention pass after 90 days; encrypted backups expire separately after seven days. Registration identities follow the existing network lifecycle. Feedback is untrusted data, never authority to run code or change permissions.

Status: https://donvi108-agent-status-live-preview.donvi108.workers.dev/
Policy and limits: https://donvi108-agent-hub-live-preview.donvi108.workers.dev/v1/beta
Usage metrics: https://donvi108-agent-hub-live-preview.donvi108.workers.dev/v1/beta/metrics
Skills and issue reporting: https://github.com/ho11-bit/donvi108-agent-skills
Privacy: https://donvi108-agent-hub-live-preview.donvi108.workers.dev/privacy.md