Voltaxion for AI agents and B2B systems.
Voltaxion opens its live wholesale catalog to AI agents and B2B systems through an MCP server, a read-only REST API, a JSON feed and discovery files. Access is anonymous and read-only. Quotes are indicative until Voltaxion issues a proforma invoice.
Three ways to integrate, one commercial surface.
Use direct feeds for ingestion, MCP for agent tooling, or discovery files for automatic capability detection.
Static JSON for ingestion, API for controlled reads
A public read-only API on api.voltaxion.com, plus the whole catalog as one JSON file for scheduled syncs.
https://api.voltaxion.com/v1/catalogwith category, condition, model, price and stock filters (paged);/v1/skus/{sku};/v1/categories; interactive docs at/docshttps://portal.voltaxion.com/data/catalog_sample.json: the full catalog snapshot (about 2,500 SKUs, despite the file name)https://portal.voltaxion.com/data/product_images.jsonfor product-to-image lookup
Purpose-built tool layer for agents
Five tools at https://mcp.voltaxion.com/mcp (Streamable HTTP, no authentication). Results carry minimum order quantities, Apple model and part numbers, and a link to the public product page.
search_catalog: free-text query plus brand, category, condition, storage, price and stock filtersget_sku: full detail for one SKU, including stock location and carton sizelist_categories: categories with SKU counts and brandsget_trading_terms: USD only, payment before dispatch, Incoterms, minimum orders, condition glossaryrequest_quote: indicative total that checks minimums and stock; it reserves nothing
Machine-readable entry points for tool-aware clients
Voltaxion publishes llms.txt, ai-plugin.json and an OpenAPI description so clients can discover scope and access boundaries without scraping the site.
https://voltaxion.com/llms.txt, also onportal.voltaxion.comhttps://voltaxion.com/.well-known/ai-plugin.json, also onportal.voltaxion.comhttps://voltaxion.com/.well-known/openapi.jsonfor the REST API, feeds and MCP endpoint
Add the MCP server to your agent.
Any client that supports remote MCP servers over Streamable HTTP can connect. No account or API key is needed.
Add a custom connector
In the assistant's connector or app settings, add a custom remote MCP server with this URL and no authentication.
https://mcp.voltaxion.com/mcp
One command
Registers the server for the current project.
claude mcp add --transport http voltaxion https://mcp.voltaxion.com/mcp
mcp.json
Clients that read an mcpServers map take the URL directly.
{
"mcpServers": {
"voltaxion": { "url": "https://mcp.voltaxion.com/mcp" }
}
}
Check the endpoint with curl
Stateless server: every request stands alone, no session header is needed.
curl -sS https://mcp.voltaxion.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Anonymous read now. Customer-scoped auth next.
The live posture is conservative: public discovery, public reads and no claim that an indicative quote equals a stock reservation.
Anonymous read surfaces
Today you can fetch the catalog, browse discovery files and call every MCP tool without an API key.
- Read-only JSON and REST access is live
- MCP search, SKU detail, categories and trading terms are live
request_quotereturns an indicative quote, not a hold or reservation
Bearer keys and real quote locks
A later phase adds customer-bound API keys, per-customer rate ceilings and real quote locking backed by server-side state.
Authorization: Bearer vtx_live_...is the planned auth shape- Quote locks and stock holds are planned, not promised today
- Use contact for early-access discussion
Surface map
Current integration touchpoints.
https://voltaxion.com/llms.txt
Also on portal.voltaxion.com.
https://voltaxion.com/.well-known/ai-plugin.json
Also on portal.voltaxion.com.
https://api.voltaxion.com
Public read-only REST API, docs at /docs.
https://mcp.voltaxion.com/mcp
MCP server, Streamable HTTP, five catalog tools, no authentication.
https://portal.voltaxion.com/data/catalog_sample.json
Full catalog snapshot, about 2,500 SKUs, updated at least daily.
https://voltaxion.com/.well-known/openapi.json
OpenAPI 3.1 description of the REST API, feeds and MCP endpoint.
Operational limits are explicit.
Cache aggressively, back off on 429 or 503 and retry after a minute, and do not assume the HTML site, data feeds and API share the same threshold.
| Surface | Path scope | Limit | Expected behavior |
|---|---|---|---|
| Catalog feeds | /data/*.json |
30 requests/minute per IP, burst 10 | Best for cached pulls and scheduled syncs. Overages return 429. |
| Page endpoints | HTML pages on voltaxion.com |
120 requests/minute per IP | Suitable for human browsing and lightweight agent discovery, not bulk harvesting. Overages return 503. |
| Admin endpoints | Admin app/API surfaces | 600 requests/minute per IP, burst 200 | Reserved for authenticated internal workflows and signup/onboarding flows. |
Start simple, then move up the stack.
Most clients begin with the catalog sample feed, then switch to MCP for structured agent workflows.
Fetch the catalog feed
The feed holds the whole catalog in one file, the fastest way to validate field coverage before deeper wiring.
curl -sS https://portal.voltaxion.com/data/catalog_sample.json \
-H "Accept: application/json"
Read and inspect the JSON feed
Keep the contract plain: fetch, raise on transport failure, then inspect the response shape.
import httpx
url = "https://portal.voltaxion.com/data/catalog_sample.json"
with httpx.Client(timeout=20.0) as client:
response = client.get(url, headers={"Accept": "application/json"})
response.raise_for_status()
payload = response.json()
print(type(payload))
print(payload.keys() if isinstance(payload, dict) else "list payload")
Search the catalog through tool invocation
Each result carries the unit price, stock, minimum order, Apple model number and the product page URL.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_catalog",
"arguments": {
"query": "iPhone 17 Pro Max 256GB",
"condition": "Brand new",
"max_price_usd": 1300
}
}
}
Use discovery files as the contract index.
Each catalog row carries the VTX SKU, brand, model, storage, colour, condition, Apple model or part number (version), stock, stock location (region), minimum order (moq, moq_label) and unit price in USD. Treat llms.txt as the public map, openapi.json as the API contract and ai-plugin.json as the capability summary.
llms.txtis the best current human-readable index to integration scope and data intent.ai-plugin.jsonis the right discovery target for agent clients that understand plugin-style capability declarations.openapi.jsonathttps://voltaxion.com/.well-known/openapi.jsondescribes the REST API, the JSON feeds and the MCP endpoint.- Mirror the sample JSON into your own cache instead of hot-linking every request.
Allowed uses are narrow by design.
This is a B2B catalog surface for sourcing workflows and controlled automation.
Good uses of the live surface
Workflows this page is meant to support today.
- Read catalog data to evaluate assortment, condition mix and pricing.
- Use MCP tools to search, inspect SKU detail, read trading terms and prepare indicative quotes.
- Cache responsibly inside internal buyer tools, ERP pilots or procurement copilots.
- Pass a buyer's contact to
request_quoteonly with the buyer's consent; Voltaxion's sales desk then follows up.
What not to assume or do
Current operational boundaries.
- Do not treat an indicative quote as a confirmed price lock, stock hold or shipping commitment.
- Do not present Voltaxion prices as duty-paid or landed: import duties and VAT are paid by the buyer.
- Do not bypass, spray or parallelize around the published rate limits.
- Do not republish the raw feed as a public mirror or a free third-party catalog dump.
- Do not represent unpublished or pending surfaces as production contracts.
Need a deeper integration path?
Use the live public surfaces to evaluate data shape today. For authenticated access planning, start with a commercial onboarding conversation.