Documentation

Build with ChemAI

Complete API documentation, integration guides, and examples. Everything you need to integrate chemical intelligence into your applications.

Quick Start API Reference

REST API

Full HTTP API reference

MCP Server

Claude & ChatGPT integration

SDKs

JavaScript & Python libraries

Authentication

API keys and OAuth

Quick Start

Get API Key

Make Request

Use our REST API or MCP server

Build

Integrate chemical intelligence into your app

Your first API call

Search for chemicals using natural language

# Search for chemicals
curl -X GET "https://chemai.com/api/chemicals?search=citric+acid&industry=food" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get chemical details
curl -X GET "https://chemai.com/api/chemicals/chem_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# MCP tool call
curl -X POST "https://chemai.com/api/mcp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/call", "params": {"name": "search_chemicals", "arguments": {"query": "preservative for beverages"}}}'

API Reference

All endpoints return JSON. Authentication via Bearer token in header.

GET

/api/chemicals

Search and list chemicals

searchcategoryindustrypagelimit

Returns: Array of chemical objects with full specifications

GET

/api/chemicals/{id}

Get detailed chemical information

Returns: Complete chemical object with pricing, suppliers, documents

GET

/api/pricing

Get platform pricing in multiple formats

format (json, csv, yaml, jsonld)

Returns: Pricing data with plans, API costs, volume discounts

POST

/api/mcp

MCP server for AI agent integration

methodparams

Returns: MCP protocol response with tool results

POST

/api/truth

Truth layer API for verified facts

chemicalIdquery

Returns: Cited facts with confidence scores and sources

POST

/api/knowledge/query

RAG-powered knowledge base query

querycontext

Returns: AI-generated answer with citations

MCP Server

Integrate ChemAI directly into Claude Desktop, ChatGPT, or any MCP-compatible AI agent. Our MCP server provides tools for chemical search, pricing, compliance, and more.

Claude Desktop Setup

Add this to your Claude Desktop config:

{
  "mcpServers": {
    "chemai": {
      "command": "npx",
      "args": ["@chemai/mcp-server"],
      "env": {
        "CHEMAI_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP Endpoint

Or use our hosted MCP endpoint directly:

POST https://chemai.com/api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}

Available Tools

search_chemicals

Search the chemical database by name, CAS number, or application

Parameters:

query: stringindustry: string?limit: number?

get_chemical_details

Get complete details for a specific chemical

Parameters:

id: string

get_pricing

Get pricing information for a chemical from all suppliers

Parameters:

chemicalId: stringquantity: number?unit: string?

get_documents

Retrieve SDS, TDS, or CoA documents

Parameters:

chemicalId: stringtype: sds|tds|coa

find_alternatives

Find alternative chemicals that can substitute for a given chemical

Parameters:

chemicalId: stringreason: string?

check_compliance

Check regulatory compliance for a chemical in specific regions

Parameters:

chemicalId: stringregions: string[]application: string?

build_formulation

Create a formulation with multiple ingredients and calculate costs

Parameters:

ingredients: arraytargetWeight: number

compare_chemicals

Compare multiple chemicals side by side

Parameters:

chemicalIds: string[]attributes: string[]?

Authentication

All API requests require authentication via Bearer token.

API Keys

Include your API key in the Authorization header:

Authorization: Bearer ck_live_xxxxx

Test keys start with ck_test_

Live keys start with ck_live_

Rate Limits

Plan	Rate Limit
Free	10 req/min
Professional	100 req/min
Enterprise	1000 req/min

SDKs & Libraries

Official client libraries for popular languages

JavaScript/TypeScript

@chemai/sdk

npm install @chemai/sdk

Python

chemai

pip install chemai

Ruby

chemai

gem install chemai

Need Help?

Our developer support team is here to help you integrate ChemAI

Contact Support GitHub