Docs

Build on ICPX compute.

SDK, MCP server, API and pay.sh integration for GPU jobs.

Program IDL NVIDIA catalog

Install SDK

Use the TypeScript client in an app, agent runtime or server worker.

Connect wallet

Use Phantom or Solflare for account access and job payment.

Select workload

Choose NVIDIA model, skill, blueprint, GPU and region.

Pay per job

Approve the job price before compute starts.

Open terminal

Attach SSH keys and run commands on the active job.

TypeScript SDK

The SDK wraps catalog lookup, job pricing, payment setup and terminal requests.

Client

Runs in browser apps, server workers and agent runtimes.

Auth

Works with account sessions or wallet sessions.

Payments

Prepares job payment for the caller to approve.

import { IcpxClient } from "@icpx/sdk";

const icpx = new IcpxClient({
  baseUrl: "https://www.icpx.cloud",
  network: "mainnet",
});

const catalog = await icpx.catalog.search({
  kind: "model",
  query: "llama",
});

const quote = await icpx.compute.quote({
  model: catalog.items[0].id,
  gpu: "H200",
  maxUnits: 100,
  paymentAsset: "ICPX",
});

MCP server

The MCP server gives agent clients a typed bridge into ICPX catalog, compute, payment and terminal actions.

icpx.catalog.search

Search NVIDIA models, skills and blueprints.

icpx.compute.quote

Build a GPU job quote from workload, GPU, units and payment asset.

icpx.compute.create

Create a job draft for wallet funding.

icpx.compute.fund

Prepare payment for a selected job.

icpx.terminal.open

Open a terminal session for an approved job.

icpx.program.idl

Return indexed IDL instructions, accounts, types and errors.

{
  "mcpServers": {
    "icpx": {
      "command": "npx",
      "args": ["@icpx/mcp-server"],
      "env": {
        "ICPX_API_URL": "https://www.icpx.cloud",
        "SOLANA_RPC": "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY"
      }
    }
  }
}

API

HTTP endpoints used by dashboard, SDK, MCP and registry tooling.

GET

/api/nvidia/catalog

Lists NVIDIA models, skills, blueprints and GPU filters.

POST

/api/pay/compute/jobs

Creates a pay.sh compatible payment request.

GET

/api/pay/compute/jobs/{jobId}

Returns the current status for a paid GPU job.

GET

/api/pay/openapi

Returns the OpenAPI document for registry tooling.

GET

/api/program/idl

Returns the ICPX Payments Solana IDL.

POST

/api/gpu/jobs

Creates a dashboard GPU job request.

POST

/api/terminal/gateway/authorize

Issues short lived terminal gateway authorization.

pay.sh integration

ICPX exposes a payment endpoint and a registry package for solana-foundation/pay-skills.

Provider package

PAY.md and openapi.json live in integrations/pay-skills/providers/icpx/compute.

Challenge

Paid calls return a payment request when no payment is attached.

Mainnet

Production requests use Solana mainnet and USDC payment challenges.

Testing

Devnet remains available inside the dashboard test flow, not the pay.sh registry listing.

PR path

Copy providers/icpx/compute into solana-foundation/pay-skills and open a pull request.

curl -i https://www.icpx.cloud/api/pay/compute/jobs \
  -H "content-type: application/json" \
  -d '{"gpu":"H200","model":"nvidia/llama","region":"us-east"}'

# returns 402 + WWW-Authenticate: Payment ...

Program

The program covers GPU job creation, payment, completion and disputes.

Catalog

NVIDIA models, skills and blueprints are available inside ICPX with internal detail pages.

OpenAPI

The pay.sh OpenAPI document is served from the application for registry tooling.