SciTuu Wet Lab ToolsBETA
ToolsHelpAccount

REMOTE MCP · BETA

Connect deterministic wet-lab tools to your AI workspace

SciTuu MCP exposes all 29 research-use-only web utilities plus authorized workspace, analysis, export and delivery operations over Streamable HTTP. OAuth scopes determine exactly which tools each client can see.

01

Configure a remote HTTP MCP client

  1. Choose Add remote MCP server or Add HTTP connector in your AI client.
  2. Set the server URL to https://scituu.com/api/mcp/v1.
  3. Your client reads SciTuu protected-resource metadata, registers as a public OAuth client when needed, and opens the SciTuu sign-in page.
  4. Sign in or register, review the requested scopes, and approve access. Access tokens expire automatically and refresh tokens rotate.
Client field names differ. Use a remote/HTTP MCP transport, not a local stdio command. The endpoint uses OAuth 2.1 authorization code + PKCE S256 and stateless JSON responses.
Use https://scituu.com/mcp/ only as this setup page. MCP clients should send JSON-RPC POST requests to https://scituu.com/api/mcp/v1; GET on that endpoint is for metadata. Do not configure an SSE transport.

02A

Generic JSON configuration

{
  "mcpServers": {
    "scituu": {
      "type": "http",
      "url": "https://scituu.com/api/mcp/v1"
    }
  }
}

02B

Verify OAuth discovery

curl https://scituu.com/.well-known/oauth-protected-resource

curl https://scituu.com/.well-known/oauth-authorization-server

03

Capability scopes

tools/list is filtered by the scopes approved for that client. A client never receives definitions for tools outside its grant.

mcp:tools       Discover and call MCP tools
lab:calculate   Deterministic wet-lab calculations
lab:plan        Plate, label, timer, freezer and equipment planning
lab:reference   Research-use-only reference lookups
profile:read      Read the signed-in user's lab profile
profile:write     Replace or reset the signed-in user's lab profile
workspace:read   Read authorized workspaces
workspace:write  Create and update workspace revisions
workspace:manage Manage enterprise workspace roles
artifact:read    Read authorized artifacts
artifact:write   Create signed artifact uploads
analysis:run     Run qPCR, ELISA, instrument and protocol analysis
export:create    Export CSV, Parquet, Croissant, ISA and RO-Crate
connector:read   Read configured external destinations
connector:prepare Prepare an approval-gated external delivery
connector:execute Execute only a server-approved one-time plan
audit:read        Verify immutable delivery receipts

03B

Recommended scope bundles

Start with the smallest bundle that matches the task, then reconnect only when the client needs more capabilities.

Calculator and planning:
  mcp:tools lab:calculate lab:plan lab:reference

Profile read/write:
  profile:read profile:write

Data workflow:
  mcp:tools workspace:read workspace:write artifact:read artifact:write analysis:run export:create tasks:read

Approval-gated delivery:
  mcp:tools connector:read connector:prepare connector:execute audit:read

Workspace administration:
  mcp:tools workspace:read workspace:write workspace:manage
If tools are missing in Codex, Claude or ChatGPT, reconnect and approve the scopes for that workflow instead of pasting a long-lived bearer token.

04 · CLIENT QUICK START

Connect in about three minutes

Add the endpoint, continue to SciTuu OAuth, sign in or register, review the requested scopes, and return to your client. The three-minute figure is a launch SLO and will be published only after real-user validation.

CODEX

Codex CLI

codex mcp add scituu \
  --url https://scituu.com/api/mcp/v1 \
  --oauth-resource https://scituu.com/api/mcp/v1

codex mcp login scituu \
  --scopes mcp:tools,lab:calculate,lab:plan,lab:reference

CLAUDE CODE

Claude Code

claude mcp add \
  --transport http \
  --scope user \
  scituu \
  https://scituu.com/api/mcp/v1

claude mcp get scituu

CHATGPT · MCP APPS UI

Rich review widgets, with JSON fallback

In ChatGPT workspaces that expose developer mode or custom MCP/App connections, add the production endpoint, complete SciTuu OAuth, and approve only the scopes your workflow needs. Supported hosts can render plate maps, protocol diffs, import mappings and secure approval checkpoints directly from MCP resources; other hosts still receive the complete structured result.

Plate mapProtocol diffImport mappingApproval checkpoint
Approval remains a signed-in SciTuu browser action. No model-generated approved:true field can authorize an external write.

05 · EXAMPLE PROMPTS

Tell your agent what to do, not which internal tool to pick

  • Use SciTuu MCP to calculate a PCR master mix for 24 reactions, 20 µL each, with 10% overage.
  • Use SciTuu MCP to import this qPCR XLSX, preview the column mapping, run ΔΔCt analysis, generate an Experiment Packet, and export CSV plus RO-Crate.
  • Prepare a Benchling delivery preview for this Experiment Packet, but do not execute it until I approve it in SciTuu.

Troubleshooting

Common client errors

  • 401 or invalid bearer: reconnect through OAuth and sign in again.
  • Missing tools: reconnect with the scopes for the workflow bundle you need.
  • Rich UI not shown: the host may not support MCP Apps UI yet; use the structured JSON result.
  • Approval blocked: open the SciTuu browser approval page because model-only approved:true is ignored.

Registered users

Website privacy mode vs. Remote MCP

Anonymous visitors can still use browser-local calculators on the website. Remote MCP is account-based so workspace files, packets, exports and approvals can be tied to the signed-in user and audited.

Calculator MCP 1.0

Stable input and output contracts

Every tool publishes inputSchema and outputSchema. Tool results use one structured envelope with data, normalized units, warnings, assumptions, provenance and stable error codes.

schemaVersion: scituu.mcp.tool-result.v1
ok: true | false
data: tool-specific output
units: normalized output units
warnings: scientific review notices
assumptions: calculation assumptions
provenance: version + input digest
error: null | stable error object

Safer client behavior

Read-only calculators are marked read-only

The 24 Calculator MCP operations are non-destructive and idempotent. PubChem is marked as an external read-only lookup. Lab profile changes are advertised as write operations only when profile:write is granted.

Invalid bearer credentials are rejected with 401 and are never downgraded to anonymous access or a browser session.