化工社 HGS AIchem
Chemistry MCP: search compounds & reactions, stoichiometry, skills and reaction records.
Hosted MCP Server
npx add-mcp 'https://huagongshe.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Connection info
MCP Server
https://huagongshe.com/mcp
Sign-in required
Public queries (exact search, compounds and public reactions, structure rendering, stoichiometry) work without an account; structure search, skills, personal data, and write actions require a connected account. Restricted calls receive a standard OAuth challenge; clients with standard MCP OAuth handle it through the MCP authorization flow (sign in or register, then approve).
Standard OAuth authorization
Structure search, skills (browsing and saving), personal data, and write operations require the matching scopes. Clients using standard MCP OAuth obtain access through the HGS account authorization (Authorization Code + PKCE S256, scopes read / reaction:write / skill:write); the authorization page lists the requested permissions.
AI Key compatibility
AI Key (compatibility)
Authorization: Bearer <AI Key>
MCP clients without standard OAuth account-linking support can use an AI Key: create one under Account settings → AI Key and delete it at any time; send it as Authorization: Bearer <AI Key>. This is the compatibility path for clients without OAuth support.
Agent Plugin
The plugin package follows the agent-plugins.org specification (containing plugin.json, mcp.json, and icon) for compatible clients. You can also connect directly to the MCP endpoint below — no plugin required.
Generic JSON config
{ "mcpServers": { "huagongshe": { "type": "streamable-http", "url": "https://huagongshe.com/mcp" } } }
If you use the AI Key compatibility path, add Authorization: Bearer <your AI Key> under headers.
Tools available to AI
13 tools in total: public queries work anonymously; structure search, skills (browsing and saving), personal data, and write operations require a connected account with the matching scopes (read / reaction:write / skill:write).
search_chemistry_data | Anonymous / +read | Unified search by name, CAS, SMILES, DOI, etc.; substructure/similarity requires the read scope |
|---|---|---|
get_chemical | Anonymous | Compound detail: enrich=core gives structure/identifiers/related reactions; full adds unified semantic detail (descriptions, properties, safety, suppliers, etc.) |
get_reaction | Anonymous / +read | Public reactions readable anonymously; connected accounts can read their own private records (read) |
render_molecule_svg | Anonymous | 2D molecular structure image (SVG) |
render_reaction_svg | Anonymous / +read | Reaction equation image (SVG) |
list_skills | Sign-in + read | Browse the public skill pool; mine lists your own skills (login required) |
get_skill | Sign-in + read | Read a skill definition, files, and SKILL.md by slug (login required) |
calculate_stoichiometry | Anonymous | Scale calculation: convert a molar basis into the full charge table and theoretical yield |
list_my_reactions | Sign-in + read | List your own reaction records |
validate_reaction | Sign-in + reaction:write | Validate a reaction draft with RDKit (not saved) |
create_reaction | Sign-in + reaction:write | Save a confirmed reaction record (idempotent, private by default) |
validate_skill | Sign-in + skill:write | Validate a skill zip draft (not saved) |
create_skill | Sign-in + skill:write | Save a skill into your container (always private) |
Data & authorization
- Reaction records are private by default; making one public requires your explicit confirmation
- Before saving, the AI must show you a draft and get your confirmation
- Authorizations and AI Keys can be revoked at any time — send them only to huagongshe.com
- Every save uses a unique Idempotency-Key, so retries never create duplicates