Developers
API and MCP Cloud
Use RBAi’s paper search and tools from your own code, Claude, Cursor, VS Code or any MCP client.
Three ways in
| Interface | Use it for | Key |
|---|---|---|
| Corpus API | Paper search from your code (REST) | rbai_sk_…, by email |
| MCP Cloud | RBAi’s database tools in any MCP client | rbai_mcp_…, from thedreamlabinnovations.com/mcp-cloud |
| MCP with your account | The RBAi agent itself, or chosen databases, in an MCP client | dlab_…, from Settings → API & MCP → API keys |
The Corpus API and account keys are on https://rbai.thedreamlabinnovations.com; MCP Cloud is its own service. Settings → API & MCP → Scholar & MCP Cloud shows what your plan includes and whether your email has a Scholar or MCP Cloud key.
Corpus API
POST /api/v1/corpus/search searches 11 million biomedical papers, by meaning (semantic, the default) or by exact terms and Boolean expressions (keyword). Use keyword mode for gene symbols, variants, accessions and trial IDs.
curl https://rbai.thedreamlabinnovations.com/api/v1/corpus/search \
-H "Authorization: Bearer rbai_sk_your_key" \
-H "Content-Type: application/json" \
-d '{"query": "MDM2 binding to the p53 transactivation domain", "topK": 5, "yearFrom": 1990}'| Field | Type | Notes |
|---|---|---|
query | string | Required. Up to 2,000 characters, so an abstract or a grant aim fits. |
topK | number | 1 to 100; 20 by default. |
mode | string | semantic (default) or keyword. |
yearFrom, yearTo | integer | 1900 to 2030. |
isOpenAccess | boolean | Only open-access papers. |
minCitations | number | 0 or more. |
journal, type, language, oaStatus | string | Filters on the paper’s metadata. |
author | string | Partial, case-insensitive author match. |
doi, pmid, titleSearch | string | Look up a paper by DOI or PMID, or match part of its title. |
The response has query, mode, count, results and took_ms. GET /api/v1/corpus/stats returns public corpus statistics.
Limits
Without a key, you get 5 searches an hour from one IP address. A key has a daily limit, which is returned as dailyLimit when the key is created.
Get a Corpus key
Confirm your email address with a one-time code. The confirmation returns your key, and makes one if the email has none. Save the key.
# 1. Email yourself a 6-digit code
curl -X POST https://rbai.thedreamlabinnovations.com/api/v1/corpus/request-otp \
-H "Content-Type: application/json" \
-d '{"email": "you@university.edu"}'
# 2. Send the code back to get your key
curl -X POST https://rbai.thedreamlabinnovations.com/api/v1/corpus/verify-otp \
-H "Content-Type: application/json" \
-d '{"email": "you@university.edu", "otp": "123456"}'The answer lists the keys of that email under keys, each with its key, tier and dailyLimit. A code lasts 10 minutes. The same code step lets you regenerate or delete the key. MCP Cloud keys are issued only at thedreamlabinnovations.com/mcp-cloud(opens in a new tab).
MCP Cloud
RBAi MCP Cloud is a service of its own at https://mcp.thedreamlabinnovations.com/mcp (MCP Streamable HTTP). It gives a client two tools: find_tools finds the right tool among RBAi’s databases from a plain-words description, and call_tool runs it. Connecting and listing tools need no key; each find_tools and each call_tool is one call of your key’s daily allowance.
Send your key as Authorization: Bearer rbai_mcp_… or as x-api-key. Get it at thedreamlabinnovations.com/mcp-cloud(opens in a new tab); Settings → API & MCP → Scholar & MCP Cloud shows your plan’s daily limits.
claude_desktop_config.json · needs Node.js 18+
{
"mcpServers": {
"rbai-mcp-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.14.3",
"https://mcp.thedreamlabinnovations.com/mcp",
"--header",
"x-api-key:${RBAI_MCP_KEY}"
],
"env": {
"RBAI_MCP_KEY": "rbai_mcp_your_key_here"
}
}
}
}MCP with your RBAi account
To give an MCP client the RBAi agent itself, create a key in Settings → API & MCP → API keys. Choose what the key can reach:
- Agent chat: the RBAi agent picks the databases, which suits most people.
- Chosen databases: the client sees only the databases you pick.
- One database: a single database.
A key can expire or stay valid until you revoke it, and you can have up to 15 active keys. The key (dlab_…) is shown once. The agent’s work is billed to your account’s credits, as in the app.
The endpoint is https://rbai.thedreamlabinnovations.com/api/mcp/protocol?server=service. With server=service you get the RBAi agent; server=core and server=extended give the database tools directly. Settings → API & MCP → API keys shows these snippets with your own key filled in.
claude mcp add rbai --transport http "https://rbai.thedreamlabinnovations.com/api/mcp/protocol?server=service" --header "Authorization: Bearer dlab_your_key"