化工社 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_dataAnonymous / +readUnified search by name, CAS, SMILES, DOI, etc.; substructure/similarity requires the read scope
get_chemicalAnonymousCompound detail: enrich=core gives structure/identifiers/related reactions; full adds unified semantic detail (descriptions, properties, safety, suppliers, etc.)
get_reactionAnonymous / +readPublic reactions readable anonymously; connected accounts can read their own private records (read)
render_molecule_svgAnonymous2D molecular structure image (SVG)
render_reaction_svgAnonymous / +readReaction equation image (SVG)
list_skillsSign-in + readBrowse the public skill pool; mine lists your own skills (login required)
get_skillSign-in + readRead a skill definition, files, and SKILL.md by slug (login required)
calculate_stoichiometryAnonymousScale calculation: convert a molar basis into the full charge table and theoretical yield
list_my_reactionsSign-in + readList your own reaction records
validate_reactionSign-in + reaction:writeValidate a reaction draft with RDKit (not saved)
create_reactionSign-in + reaction:writeSave a confirmed reaction record (idempotent, private by default)
validate_skillSign-in + skill:writeValidate a skill zip draft (not saved)
create_skillSign-in + skill:writeSave 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