Developers
Connect an agent
Build AI research workflows with scoped, metered access to SPHERE. Claude, Cursor or your own agent sees what you can see, and purchases require your confirmation.
terminal
claude mcp add --transport http sphere https://sphere.evee.ai/api/mcpThen run /mcp in Claude Code and choose Authenticate.
# REST, with an API key curl -H "Authorization: Bearer $SPHERE_KEY" https://sphere.evee.ai/api/v1/datasets
Remote · recommendedhttps://sphere.evee.ai/api/mcpHosted server. Sign in with OAuth; scopes follow what you allow. API keys work too.
Local · for institutionssphere mcp serveBundled with Sphere Desktop and the CLI. Your agent works over your local SPHERE copies; originals stay blocked unless you allow each call.
| Tool | What it does | Access |
|---|---|---|
| search_catalog | Search listed datasets on Sphere by need. | free |
| get_dataset | Full details of one dataset: description, columns and their protection, privacy metrics, versions, source, license.. | free |
| list_my_access | Datasets you can read, with version, expiry and usage. | your grants · metered |
| list_workspace | The buyer's workspace: imported tables (table name, columns and types, rows, version, whether a newer version or lost access needs attention, aggregates-only) and recent query runs.. | your grants · metered |
| import_dataset | Import a dataset you has access to into their workspace as a SQL table: their pinned version with the owner's policies applied. | your grants · metered |
| run_sql | Run one PostgreSQL query (SELECT / WITH) in isolated compute over the workspace's imported tables; tables can be joined. | your grants · metered |
| save_work | Keep a query run as named finished work in the workspace (or rename it).. | your grants · metered |
| read_rows | Read rows of a dataset's protected twin that you have access to (never raw data). | your grants · metered |
| list_my_jobs | Your jobs, newest first, with status and the released headline. | approved by the owner |
| get_job | One of your jobs: its status, where it runs (twin or the owner's raw source), and, once the owner releases it, the full output table and the checks it passed.. | approved by the owner |
| submit_job | Ask the owner to run an analysis on a dataset you have access to, described in words (e.g. | approved by the owner |
| run_template | Run one of the owner's pre-approved analyses on a dataset you can read. | approved by the owner |
| request_access | Ask the owner of a listing for access, optionally on a specific plan, with your purpose. | you confirm |
| list_my_requests | The buyer's access requests and their status, with any reply from the owner.. | you confirm |
| prepare_purchase | Check whether a listing can be bought and get a link for a person to buy it in Sphere. | you confirm |
| search_world | Search SPHERE's public research projects, their twin datasets and institutions by text, best match first: describe the data you need in plain words; each result has a score, the words it matched and whether it matched them all. | free |
| describe | One project (id or org/slug), dataset or twin version in detail: readme, twins with their certificates and columns, files. | free |
| query | Read rows of a twin: synthetic data, never real participants. | your grants · metered |
| run_on_twin | Run your analysis code in SPHERE's sandbox on one or more twins (synthetic data only, never real). | your grants · metered |
| request_real_run | Ask a data owner to run your code on their real table. | free |
| get_request | A run request on real data: status, timeline and, once the owner approves, released_result (what the owner released). | free |
| research_search | Search the selected release's authorized published descriptions/schema using exact terms and controlled healthcare synonyms. | free |
| research_analyze | Run a validated aggregate analysis on a specific permitted hosted copy. | your grants · metered |
| research_table | Calculate and display a research table from an authorized published SPHERE copy. | your grants · metered |
| research_plot | Calculate and display a bar or dot plot with an exact-value table from an authorized published SPHERE copy. | your grants · metered |