datapoint.market_ ALPHA v0.0.1

Guide: Use datapoint.market as an agent (with or without the connector)

This is the one-page orientation for an LLM/agent (Claude or any other). It maps every task to both ways of using the marketplace and lays out the payment options. Skim this first, then jump to the detailed guide for whatever you’re doing.

Two ways to use it

Connector (MCP)Raw HTTP (no connector)
WhatThe management MCP at POST /mcp, “connected in Claude”Plain HTTPS — any agent/SDK, no setup
Discoversearch_marketplace, get_endpoint_sampleGET /discover.json, GET /e/{provider}/{endpoint}/schema.json
Buycall_endpoint / call_mcp_toolGET/POST the relay_url → x402
Sellcreate_api_relay / create_mcp_wrapper / create_dataset → publish_endpointREST POST /dashboard/endpoints/* with an automation key
Authper-capability (below)none to buy; a Bearer empk_… key to sell

You don’t have to choose up front. Browsing and buying work either way and need no account. The connector just bundles discover + pay-from-a-managed-wallet so an agent that can’t sign crypto can still buy.

Connector auth is per-capability

  • Browse + buy = no account. initialize, tools/list, whoami, search_marketplace, get_endpoint_sample, quote_endpoint, call_endpoint, call_mcp_tool all work anonymously — the payment credential in the call is the authorization.
  • Sell + custodial wallet setup = a verified-email account. Calling one of those tools without it returns a 401 OAuth challenge → sign in with email. (See Connect in Claude.)

Who am I? Call whoami any time to see which account the connector is acting as — slug, email, and email_verified (authenticated:false if anonymous). That’s the way to confirm the email on your account through the connector.

1 · Discover & evaluate (free, no account, either mode)

Always check the free sample before paying — it’s the response JSON Schema + a synthetic example + state axes (protection/provenance/freshness).

  • Connector: search_marketplace(query?, type?) → results carry the sample inline; get_endpoint_sample(provider, endpoint) for the full one. type = api | mcp | dataset | synthetic (synthetic = data labeled synthetic, with its dataset_provenance attached).
  • Raw: GET /discover.json (the feed), GET /e/{p}/{e}/schema.json (one sample), or read the sample straight from the 402 body.

Read the schema, not the synthetic values. Listings also carry trust signals: verified (origin probed OK) and reliability (success rate + latency over recent paid traffic).

2 · Buy — the options

A buy never happens without explicit intent. Pick the path that fits:

OptionHowModeUse when
Free trialcall with no paymentbothAn unpaid call to a trial_safe endpoint returns real data (metered). Try before you pay.
Pay from your managed walletcall_endpoint(..., confirmed=true)connectorThe simple custodial path: fund a managed wallet once, then buy. No keys to manage.
BYO wallet (sign yourself)sign the x402 accepts → X-PAYMENTbothYou hold your own wallet/key and want non-custodial settlement. Raw: resend with the header. Connector: pass signed_payment.
Delegated budget (buy job)hand a capped spk_ to a separate agentconnectorAdvanced. Give another agent process a bounded, disposable budget. Most buyers skip this.

Every paid call returns the origin’s real data plus an on-chain receipt (tx_hash). To bound autonomous spend, set an account policy (set_buy_policy: max_per_call, confirm_above).

3 · Sell (needs a verified-email account)

Same in both modes — wrap an origin and publish:

  • Connector: create_api_relay (HTTP origin) / create_mcp_wrapper (MCP server) / create_dataset (a downloadable file) → publish_endpoint.
  • Raw REST: POST /dashboard/endpoints/{api,mcp} with Authorization: Bearer empk_….

Buyers get a free synthetic sample of your response automatically; you can offer metered free trials of real data (trial_safe + free_trial_calls). Datasets declare a format (csv/parquet/…) and license; synthetic datasets must declare provenance. Details: Publish · Sell a dataset · Getting paid.

Where to go next