Three pillars

Three ways to integrate, one commercial surface.

Use direct feeds for ingestion, MCP for agent tooling, or discovery files for automatic capability detection.

REST and JSON

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/catalog with category, condition, model, price and stock filters (paged); /v1/skus/{sku}; /v1/categories; interactive docs at /docs
  • https://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.json for product-to-image lookup
MCP server

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 filters
  • get_sku: full detail for one SKU, including stock location and carton size
  • list_categories: categories with SKU counts and brands
  • get_trading_terms: USD only, payment before dispatch, Incoterms, minimum orders, condition glossary
  • request_quote: indicative total that checks minimums and stock; it reserves nothing
Discovery files

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 on portal.voltaxion.com
  • https://voltaxion.com/.well-known/ai-plugin.json, also on portal.voltaxion.com
  • https://voltaxion.com/.well-known/openapi.json for the REST API, feeds and MCP endpoint
Connect

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.

Claude, ChatGPT and other assistants

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
Claude Code

One command

Registers the server for the current project.

claude mcp add --transport http voltaxion https://mcp.voltaxion.com/mcp
Cursor and JSON-configured clients

mcp.json

Clients that read an mcpServers map take the URL directly.

{
  "mcpServers": {
    "voltaxion": { "url": "https://mcp.voltaxion.com/mcp" }
  }
}
Raw JSON-RPC

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"}'
Access model

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.

Live now

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_quote returns an indicative quote, not a hold or reservation
Planned

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
Endpoints

Surface map

Current integration touchpoints.

Live https://voltaxion.com/llms.txt Also on portal.voltaxion.com.
Live https://voltaxion.com/.well-known/ai-plugin.json Also on portal.voltaxion.com.
Live https://api.voltaxion.com Public read-only REST API, docs at /docs.
Live https://mcp.voltaxion.com/mcp MCP server, Streamable HTTP, five catalog tools, no authentication.
Live https://portal.voltaxion.com/data/catalog_sample.json Full catalog snapshot, about 2,500 SKUs, updated at least daily.
Live https://voltaxion.com/.well-known/openapi.json OpenAPI 3.1 description of the REST API, feeds and MCP endpoint.
Rate limits

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.
Code examples

Start simple, then move up the stack.

Most clients begin with the catalog sample feed, then switch to MCP for structured agent workflows.

curl

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"
Python httpx

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")
MCP

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
    }
  }
}
Schema and discovery

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.

Usage policy

Allowed uses are narrow by design.

This is a B2B catalog surface for sourcing workflows and controlled automation.

Allowed

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_quote only with the buyer's consent; Voltaxion's sales desk then follows up.
Not allowed

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.
Planned: programmatic quote-and-lock with authenticated customer keys, per-customer controls and server-side stock holds. Until then, orders are confirmed by a Voltaxion proforma invoice, which holds its price for 24 hours.

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.