Sandbox
The production release on Base Sepolia, with its own data and testnet funds — where every tutorial in these docs runs.
The sandbox is where you build and test against the Molecule API without spending real money. It runs the same release as production, with production's configuration and limits, on Base Sepolia with its own contracts and its own data. Every Getting Started tutorial runs against it.
Because it mirrors production, code that works on the sandbox works on production once you swap a handful of constants — see Running in Production.
Endpoints
GraphQL API
https://sandbox.graphql.api.molecule.xyz/graphql
https://production.graphql.api.molecule.xyz/graphql
https://cjwbtwwqz2.execute-api.eu-central-2.amazonaws.com/prod
https://0qb5gyw72f.execute-api.eu-central-2.amazonaws.com/prod
Agent Connect MCP server
https://sandbox.mcp.molecule.xyz
https://mcp.molecule.xyz
Agent Connect authorization server
https://sandbox.agent-connect.molecule.xyz
https://agent-connect.molecule.xyz
Chain
Base Sepolia (84532)
Base (8453)
The sandbox contract set — factory, LabNFT, AccessResolver, tokenizer and the rest — is on Supported Networks & Contracts.
To try Agent Connect against a sandbox lab, paste https://sandbox.mcp.molecule.xyz into your app instead of the production address.
Getting a credential
Sign in to the sandbox Labs app at sandbox.app.molecule.xyz.
Open the API credentials page and click Create.
Copy the
mol_usr-…credential straight away — it's shown once.
Credentials are per environment: a sandbox credential doesn't authenticate against production, and a production credential doesn't work here. Everything else about credentials — lifetime, the limit of 5 active ones, revoking, the API terms — is the same as in production and covered in Authentication.
Testnet funds
You need funds only for onchain steps, such as minting a LabNFT from code, and for paying through the x402 gateway:
Base Sepolia ETH for gas, from a Base Sepolia faucet.
Base Sepolia USDC, only for the x402 gateway, from the Circle faucet (select Base Sepolia).
Creating a lab in the sandbox Labs app needs no funds: Molecule covers those transactions, as it does in production.
Sandbox data is permanent
Treat everything you put in the sandbox as public and permanent:
Onchain state stays. LabNFTs, role grants and every other transaction live on Base Sepolia for good.
Data rooms keep every version. A file you upload is committed to the lab's data room with its history. Deleting it hides it from the API; it does not erase it.
Use test data only. Don't upload real research data, personal data or anything confidential, even encrypted.
The sandbox may be reset by a contract redeploy. If that happens, the contract addresses change and labs created on the old contracts don't carry over. A reset is announced in advance in the API Changelog.
Demo lab
The sandbox has a public demo lab you can query straight away, before you create a lab of your own:
Name
Schrödinger's Catnip Lab
shortname
schrodingers-catnip-lab
Lab page
sandbox.app.molecule.xyz/labs/schrodingers-catnip-lab (sign in to the sandbox Labs app first)
oclId
0x0101000000000000000000000064fc5fc7134a36be03b7bc56a852abf996dc33
labNftTokenId
0
Public file
/preprints/catnip-superposition-preprint-v1.pdf
Read it and its files with your sandbox credential:
Differences from production
Only these:
Chain and contracts. Base Sepolia and the sandbox contract set, instead of Base and the production set.
Funds. Testnet ETH and USDC, so nothing costs real money.
Data. The sandbox has its own labs, files and credentials. Nothing is shared with production in either direction.
The API release, the schema and the limits are the same — introspection is off and query depth is capped at 10 in both. See Rate & Query Limits and Getting the schema.
Last updated
Was this helpful?