# DatasheetVend

> Source-grounded extraction of engineering datasheets into machine-readable contracts, audited by deterministic rules, served to humans, scripts and AI agents.

DatasheetVend turns a PDF datasheet into per-module JSON contracts (pinout, footprint, thermal, timing, register map, logic levels, absolute maximum ratings, part decoder, passive BOM, peripheral matrix, power and battery, analog specs, pin cautions and design rules, document map), plus KiCad symbol and footprint files. A separate route parses an Altium ASCII footprint export that you supply into a reviewable geometry payload. Values carry a `confidence_score` from 0.0 to 1.0 and, where the module recorded them, the page they came from (`source_page`) and the text they were read from (`source_text_snippet`). Warnings flag anything inferred or ambiguous. A language model reads the PDF; deterministic code checks what it read and writes the CAD files (package resolution from the part number, simplified IPC-7351B land-pattern math, rule checks).

## Discovery
- [MCP Server Card](https://datasheetvend.com/.well-known/mcp.json): MCP server card, generated from the live tool registry.
- [OpenAPI Specification](https://datasheetvend.com/.well-known/openapi.json): OpenAPI 3.1 document for the REST API.
- [JSON Schema Registry](https://datasheetvend.com/api/v1/schemas): Which modules publish a JSON Schema and where to fetch each one.
- [LLMs Manifest](https://datasheetvend.com/llms.txt): This machine-readable discovery document.

## MCP Server & Tools
- [MCP Live Endpoint](https://datasheetvend.com/api/mcp): Streamable HTTP JSON-RPC endpoint (`POST https://datasheetvend.com/api/mcp`). Authentication: `Authorization: Bearer dsv_...` or machine payments via HTTP 402 challenge.
- `datasheetvend_build_component_twin`: Extract a datasheet into a component twin ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_decode_part_number`: Decode manufacturer ordering part numbers ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_absolute_max`: Extract absolute maximum ratings ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_altium_bundle`: Parse an Altium Designer ASCII footprint export ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_analog_specs`: Extract analog domain specifications (ADC/DAC, Op-Amps, VREF) ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_document_map`: Map a datasheet (deterministic index) ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_kicad_bundle`: Extract complete KiCad CAD bundle ($3.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_kicad_footprint`: Extract KiCad PCB footprint (.kicad_mod) ($3.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_kicad_symbol`: Extract KiCad schematic symbol (.kicad_sym) ($3.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_logic_levels`: Extract DC logic levels and operating conditions ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_package_dimensions`: Extract package dimensions and land geometry ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_passive_bom`: Extract passive support BOM ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_peripheral_matrix`: Extract on-chip peripheral matrix ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_pin_cautions`: Extract pin cautions and design rules ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_pinout`: Extract datasheet pinout ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_power_domains`: Extract power domains and consumption ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_register_map`: Extract hardware register map ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_thermal_limits`: Extract thermal resistance and operating limits ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_extract_timing_characteristics`: Extract AC timing characteristics ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_get_component_twin`: Read a datasheet's component twin ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_inspect_document_page`: Inspect one mapped page (Tier-2 detail) ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_list_component_twins`: List your datasheets that have a component twin ($2.00 USD per call with a machine payment, or credits with an API key)
- `datasheetvend_list_hardware_modules`: List the hardware intelligence modules (free)
- `datasheetvend_read_document_map_instructions`: Document Map usage instructions (free)

## REST API Endpoints
- [Extraction Launcher](https://datasheetvend.com/api/v1/extract): Start an asynchronous extraction job (`POST /api/v1/extract`).
- [Document Map Endpoint](https://datasheetvend.com/api/document-map/extract): Deterministic table of contents and section mapping (`POST /api/document-map/extract`).
- [Rulebook Catalog](https://datasheetvend.com/api/v1/rules/catalog): Design rule taxonomy recognized by the deterministic audit engine.
- [Design Rule Crosscheck](https://datasheetvend.com/api/v1/workbench/crosscheck): Audit a KiCad netlist against extracted datasheet truth.
- `cad_normalized` → `GET /api/v1/jobs/{job_id}/cad-normalized` (schema: `GET /api/v1/schemas/cad_normalized`)
- `ucm` → `GET /api/v1/jobs/{job_id}/ucm` (schema: `GET /api/v1/schemas/ucm`)
- `document_map` → `GET /api/v1/jobs/{job_id}/document-map` (schema: `GET /api/v1/schemas/document_map`)
- `kicad` → `GET /api/v1/jobs/{job_id}/kicad` (schema: `GET /api/v1/schemas/kicad`)
- `pinout` → `GET /api/v1/jobs/{job_id}/pinout` (schema: `GET /api/v1/schemas/pinout`)
- `footprint` → `GET /api/v1/jobs/{job_id}/footprint` (schema: `GET /api/v1/schemas/footprint`)
- `thermal` → `GET /api/v1/jobs/{job_id}/thermal` (schema: `GET /api/v1/schemas/thermal`)
- `absolute_max` → `GET /api/v1/jobs/{job_id}/absolute-max` (schema: `GET /api/v1/schemas/absolute_max`)
- `altium` → `GET /api/v1/jobs/{job_id}/altium` (schema: `GET /api/v1/schemas/altium`)
- `analog_intelligence` → `GET /api/v1/jobs/{job_id}/analog-intelligence` (schema: `GET /api/v1/schemas/analog_intelligence`)
- `logic_levels` → `GET /api/v1/jobs/{job_id}/logic-levels` (schema: `GET /api/v1/schemas/logic_levels`)
- `part_decoder` → `GET /api/v1/jobs/{job_id}/part-decoder` (schema: `GET /api/v1/schemas/part_decoder`)
- `passive_bom` → `GET /api/v1/jobs/{job_id}/passive-bom` (schema: `GET /api/v1/schemas/passive_bom`)
- `peripheral_matrix` → `GET /api/v1/jobs/{job_id}/peripheral-matrix` (schema: `GET /api/v1/schemas/peripheral_matrix`)
- `pin_cautions` → `GET /api/v1/jobs/{job_id}/rules` (schema: `GET /api/v1/schemas/pin_cautions`)
- `power_battery` → `GET /api/v1/jobs/{job_id}/power-battery` (schema: `GET /api/v1/schemas/power_battery`)
- `register_map` → `GET /api/v1/jobs/{job_id}/register-map` (schema: `GET /api/v1/schemas/register_map`)
- `timing` → `GET /api/v1/jobs/{job_id}/timing` (schema: `GET /api/v1/schemas/timing`)

## Documentation & Pages
- [Documentation Index](https://datasheetvend.com/docs): Documentation index with the four-call quickstart.
- [API Reference](https://datasheetvend.com/docs/api): REST API endpoints, schemas, and response shapes.
- [AI & Deterministic Guidelines](https://datasheetvend.com/docs/ai-guidelines): What the model decides and what only the rules decide.
- [Agent Gateway & MCP](https://datasheetvend.com/for-agents): MCP server, REST API, and machine payments for agents.
- [Component Catalog](https://datasheetvend.com/components): Microcontroller, power & analog IC, discrete and logic, interface IC and sensor datasheets catalog from dozens of manufacturers.
- [Pricing & Plans](https://datasheetvend.com/pricing): Free evaluation, per-module credits, and top-ups.
- [Security Posture](https://datasheetvend.com/security): How uploads are handled: deletion by default, no model training on your files, guarded downloads, and where the controls stop.
- [Privacy Policy](https://datasheetvend.com/privacy): What is kept, for how long, who processes it, and your data rights.
- [Trust & Verification](https://datasheetvend.com/trust/verification): What each extraction is checked for: source pages, package and pin-count checks, review decisions, and what the checks still miss.
- [Subprocessors](https://datasheetvend.com/trust/subprocessors): Every company that processes customer data, what it receives and where it runs. As JSON: https://datasheetvend.com/api/v1/trust/subprocessors
- [Trust Updates](https://datasheetvend.com/trust/updates): Dated changes to subprocessors and data handling. RSS: https://datasheetvend.com/api/v1/trust/updates/rss