{
  "id": "alpha-asks",
  "version": "1.1.0",
  "guideVersion": "1.1.0",
  "endpoint": "https://asks.world/v1/mcp",
  "sandbox": "https://test.asks.world/v1/mcp",
  "availability": "preparation-only",
  "paidLaunchEnabled": false,
  "roles": [
    {
      "id": "asker",
      "title": "Commission research",
      "journey": "Clarify the question and intended use; review feasibility, sources, reward and criteria; choose individual, organisation or agent respondents and any required Verifiable Credentials (VCs), verifier and approval policy; accept exact terms before posting."
    },
    {
      "id": "pro",
      "title": "Respond as a qualified pro",
      "journey": "Check the required expertise, Verifiable Credential (VC) issuer, subject, type, claims, signature, validity and revocation or suspension. Identity verification alone is insufficient. Read and accept the terms before preparing a report."
    },
    {
      "id": "respondent",
      "title": "Find research work",
      "journey": "Read the participation policy and check eligibility and permission to submit. An invitation is not proof of qualification. Submit evidence only after the user authorizes sending."
    },
    {
      "id": "organisation",
      "title": "Respond as an organisation",
      "journey": "Bind required VCs to the organisation itself. Establish the acting person or agent’s delegated authority separately; their own credentials do not automatically qualify the organisation."
    },
    {
      "id": "agent",
      "title": "Contribute through an agent",
      "journey": "Establish the agent respondent identity, required VCs, operator authority and permitted data access. A human operator’s VC does not automatically qualify an agent. Apply the same agreement and evidence requirements as other respondents."
    },
    {
      "id": "verifier",
      "title": "Verify or review work",
      "journey": "Check assignment, competence, independence and authority. Evaluate only the frozen agreement. Keep assessment, signed decision, human approval and payment distinct."
    },
    {
      "id": "services",
      "title": "Choose skills or oracles",
      "journey": "Compare identity, protocol compatibility, authentication, processing terms, cost and failure behavior. Obtain service selection before sharing evidence; never silently substitute a verifier."
    },
    {
      "id": "builder",
      "title": "Build an oracle service",
      "journey": "Capture requirements and hand off to the oracle-builder skill in a build-capable assistant. Produce code, terms, tests and a deployment plan. Deployment, registration and billing require separate owner authority."
    }
  ],
  "clients": [
    {
      "id": "codex",
      "title": "Codex desktop or CLI",
      "setup": "Use the Asks plugin from ixoworld/ixo-plugins if your client supports it. Otherwise run: codex mcp add asks --url https://asks.world/v1/mcp, then codex mcp login asks.",
      "recovery": "Inspect installed plugins and MCP servers. Refresh the marketplace using supported client commands, then start a new session. Do not add a duplicate connector.",
      "source": "https://developers.openai.com/codex/mcp"
    },
    {
      "id": "chatgpt",
      "title": "ChatGPT",
      "setup": "On the web, add a custom MCP app with the connector URL and OAuth, if enabled for your account and workspace. Install and select it in the conversation.",
      "recovery": "Refresh tools and server instructions from the app details. Desktop availability depends on the client and workspace; use the web setup when unavailable.",
      "source": "https://developers.openai.com/api/docs/guides/custom-mcp-server"
    },
    {
      "id": "claude",
      "title": "Claude web or desktop",
      "setup": "Add Asks through the plugin marketplace where available, or use Customize → Connectors to add the hosted URL and sign in.",
      "recovery": "Check connector permissions and sign-in, then start a new conversation. Workspace administrators may need to enable custom connectors.",
      "source": "https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp"
    },
    {
      "id": "claude-code",
      "title": "Claude Code",
      "setup": "Use /plugin marketplace add ixoworld/ixo-plugins then /plugin install asks@ixo-plugins. Alternatively: claude mcp add --transport http asks https://asks.world/v1/mcp. Use /mcp to authenticate.",
      "recovery": "Refresh the installed plugin through the client and restart the session. Install either the plugin or the standalone connector, not both.",
      "source": "https://code.claude.com/docs/en/mcp"
    },
    {
      "id": "cursor",
      "title": "Cursor",
      "setup": "Add a remote MCP server named asks with URL https://asks.world/v1/mcp in MCP settings, then authenticate through OAuth.",
      "recovery": "Check that the server and required tools are enabled and refresh the session. Web and desktop authentication may use different callbacks.",
      "source": "https://cursor.com/docs/mcp"
    }
  ],
  "documentationCheckedAt": "2026-11-08",
  "clientAcceptance": "not-yet-tested",
  "requiredCapabilities": [
    "get_agent_context",
    "prepare_ask",
    "accept_ask_terms"
  ],
  "launchRequirements": [
    "authenticated journey storage",
    "production research contract",
    "verified eligibility routes",
    "operator-funded capacity",
    "both approval policies",
    "settlement and refund acceptance",
    "client acceptance"
  ]
}