SafetyDataSheetAPI MCP
This official MCP server allows AI agents to extract structured 16-section JSON records from Safety Data Sheet (SDS/MSDS) PDFs. It supports single document extraction, bulk job submission with idempotency, and job status polling, utilizing the same authentication and rate limits as the REST API.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://safetydatasheetapi.com/mcpWhat you can do with it
- Extract single SDS PDF into structured JSON
- Submit bulk extraction jobs for multiple PDFs
- Poll bulk job status and retrieve results
- Check account balance and usage history
Source and maintenance
Protocol and capabilities
- Server
- safetydatasheetapi 1.1.0
- MCP protocol
- 2025-06-18
- Tools
- 4 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
4 advertised
extract_sds — Extract one SDS
Extract one Safety Data Sheet PDF into a normalized 16-section record (product identification, hazards, composition, first aid, transport, regulatory, and more) plus a confidence_score and warnings. Provide the PDF as file_url (a public https URL) or file_base64. Billed per document from prepaid credit (failures are not billed). Requires an API key.
{
"type": "object",
"oneOf": [
{
"required": [
"file_url"
]
},
{
"required": [
"file_base64"
]
}
],
"properties": {
"file_url": {
"type": "string",
"format": "uri",
"description": "Public https URL of the SDS PDF."
},
"filename": {
"type": "string",
"description": "Optional file name, for example acetone-sds.pdf."
},
"file_base64": {
"type": "string",
"description": "Base64-encoded SDS PDF bytes (use for small files)."
},
"language_hint": {
"type": "string",
"description": "Optional language hint such as en, de, fr."
},
"schema_version": {
"type": "string",
"description": "Optional output schema version."
},
"include_formats": {
"type": "array",
"items": {
"enum": [
"xml",
"csv"
],
"type": "string"
},
"description": "Also return the XML and/or CSV renderings. Omitted by default to keep results compact."
}
}
}{
"title": "Extract one SDS",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}submit_bulk_extraction — Submit a bulk extraction job
Submit up to 10 SDS PDFs (public https URLs) as one asynchronous job. Returns a job_id; poll get_bulk_job until status is completed or failed. Reuse the same idempotency_key when retrying so no duplicate job is created. Billed per document from prepaid credit, reserved up front and released for any file that fails. Requires an API key.
{
"type": "object",
"required": [
"file_urls"
],
"properties": {
"file_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 10,
"minItems": 1,
"description": "Public https URLs of SDS PDFs."
},
"callback_url": {
"type": "string",
"format": "uri",
"description": "Optional https URL that receives a signed webhook when the job finishes."
},
"language_hint": {
"type": "string"
},
"schema_version": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"description": "Caller-chosen unique key; a repeat returns the existing job."
}
}
}{
"title": "Submit a bulk extraction job",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_bulk_job — Get bulk job status
Get the status and per-file results of a bulk extraction job created by submit_bulk_extraction. Read-only and safe to repeat. Requires an API key.
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "The job_id returned by submit_bulk_extraction."
}
}
}{
"title": "Get bulk job status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_account — Get account balance and usage
Get the prepaid credit balance, price per document, and the last 30 days of usage for the account that owns the API key. Read-only. Requires a per-customer API key.
{
"type": "object",
"properties": {}
}{
"title": "Get account balance and usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 929 ms
- 95th percentile latency
- 929 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 929 ms · metadata changed · 4 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http safetydatasheetapi-mcp https://safetydatasheetapi.com/mcpCodex
codex mcp add safetydatasheetapi-mcp --url https://safetydatasheetapi.com/mcpCursor
{
"mcpServers": {
"safetydatasheetapi-mcp": {
"url": "https://safetydatasheetapi.com/mcp"
}
}
}Cline
{
"mcpServers": {
"safetydatasheetapi-mcp": {
"type": "streamableHttp",
"url": "https://safetydatasheetapi.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"safetydatasheetapi-mcp": {
"type": "http",
"url": "https://safetydatasheetapi.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http safetydatasheetapi-mcp https://safetydatasheetapi.com/mcpClaude Desktop
{
"mcpServers": {
"safetydatasheetapi-mcp": {
"url": "https://safetydatasheetapi.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"safetydatasheetapi-mcp": {
"serverUrl": "https://safetydatasheetapi.com/mcp"
}
}
}Let your agent find its tools
Find servers like SafetyDataSheetAPI MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run SafetyDataSheetAPI MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.