Ranomics Platform

com.ranomicsPublished by ranomics.comOfficial publisherv0.1.0Updated Oct 28, 2026

Wet-lab triage for AI binder-design agents. Yeast display, mammalian display, DMS at library scale.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & CommerceAI & ML

Overview

AI-generated overview

Remote MCP server that lets an AI assistant price, submit, track and retrieve wet-lab binder-triage experiments (yeast/mammalian display, DMS).

What you can do
  • List the calibrated antigen catalogue with target IDs, supported experiment types and typical campaign cost ranges
  • Estimate a non-binding USD cost for a catalog or custom target before submitting
  • Submit a binder panel experiment with target, library design and amino-acid sequences
  • Poll experiment status and status log, and fetch the quote once one is issued
  • Confirm a quote to move an experiment into the materials stage
  • Retrieve per-sequence enrichment results, hit calls and signed download links for CSV, FASTA and optional FASTQ
When to use it
Use it when an AI agent designs protein binders and you want to hand a panel to a real wet-lab triage service, budget it first, and pull enrichment results back into the workflow. Useful for teams already working with Ranomics or comparing catalog targets.
Requirements
Remote streamable HTTP endpoint at mcp.ranomics.com; no local package. A bearer API key is required in the Authorization header, minted from the Ranomics account API-keys page. Network access to the endpoint and to the signed result download URLs.
Before you install
The API key is a live credential sent in the Authorization header; keep it out of logs and shared configs. Submitting experiments and confirming quotes commit real, paid wet-lab work: confirm_quote accepts a quoted total_usd and moves the order forward, so gate it behind human or budget approval. Cost estimates are non-binding, and custom targets require a human quote. Sequences and experiment specs are sent to a third-party service.

Installation

In SourceWeft

  1. Open Ranomics Platform in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.ranomics%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ranomics-platform": {
      "type": "http",
      "url": "https://mcp.ranomics.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

This repository has no README.

Tools

7

list_targets

List the calibrated antigen catalogue. Each entry carries target_id, supported_experiment_types, and typical_campaign_range_usd. Use the target_id on submit_experiment to skip human scoping, or use the custom target shape for a one-off antigen.

Takes no parameters.

estimate_cost

Non-binding USD cost estimate for a hypothetical submission. Pass target_kind='catalog' + target_id for a calibrated band (requires_human_quote=false), or target_kind='custom' for a placeholder order-of-magnitude band (requires_human_quote=true). Call BEFORE submit_experiment when budgeting matters.

Parameterstarget_idtarget_kindcandidate_countexperiment_typerequiredlibrary_diversity

submit_experiment

Submit a binder panel for wet-lab triage. The experiment_spec mirrors the curl /api/v1/experiments contract: experiment_type (yeast_display/mammalian_display/dms), target (target_id or custom), library_design, and sequences as {user_key: amino_acid_string} (use ':' as a multi-chain separator). Optional webhook_url receives signed POSTs on every status transition. Optional idempotency_key dedupes retries. Returns the created experiment with status WaitingForConfirmation and a status_log. Poll get_experiment_status to track progress, get_experiment_results when status_log shows Done.

Parametersnamewebhook_urlexperiment_specrequiredidempotency_key

get_experiment_status

Poll an experiment by id. Returns the current status (Draft/WaitingForConfirmation/QuoteSent/WaitingForMaterials/LibraryConstruction/Sorting/NGS/DataAnalysis/InReview/Done), the orthogonal results_status (none/partial/all), and the status_log. Cheap; safe to poll every few minutes. Webhooks are preferred for production agents.

Parametersexperiment_idrequired

get_experiment_quote

Fetch the quote for an experiment once status is QuoteSent. Returns quote_id, total_usd, currency (default USD), line_items, valid_until, and terms_url. If status is QuoteSent but the scoping team has not posted a price yet, total_usd is null and a 'note' field explains it is being finalised; poll again until total_usd populates. Pass the quote_id to confirm_quote to accept.

Parametersexperiment_idrequired

confirm_quote

Accept a quote. Moves the experiment from QuoteSent to WaitingForMaterials. Call after a human (or budget guard) has approved the total_usd from get_experiment_quote. Returns 409 quote_not_confirmable if status is not QuoteSent, or 409 quote_not_finalized if a price has not been posted yet (total_usd null). Fetch get_experiment_quote and wait for total_usd before confirming.

Parametersquote_idrequired

get_experiment_results

Fetch results once results_status is 'partial' or 'all' (check via get_experiment_status first). Returns per-sequence pre/post counts, log2_enrichment, percentile, called_hit booleans, plus signed download URLs for the enrichment table CSV, hits FASTA, and (when opted in) raw FASTQ. Yeast-display result shape; mammalian and DMS use the same envelope.

Parametersexperiment_idrequired

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.