# New Runtime for developers and agents

> Discover and read New Runtime through typed JSON routes, compact Markdown, OpenAPI, feeds, a resources-only Streamable HTTP MCP endpoint, and optional x402 paid compute products.

Last reviewed: 2026-09-01.

## Quickstart

Published records and ordinary public reads require no API key, login, payment, or sandbox account. Start with llms.txt, narrow the relevant collection, and retrieve only the detail records needed for the task. Optional paid compute products are advertised separately and always begin with an unsigned request.

### Compact agent map

```bash
curl -sS https://newruntime.com/llms.txt
```

### Typed pattern index

```bash
curl -sS https://newruntime.com/patterns.json
```

### Canonical page as Markdown

```bash
curl -sS -H 'Accept: text/markdown' https://newruntime.com/
```


## Contracts and discovery

The primary OpenAPI document covers the programmatic JSON, MCP, and paid compute surface. The separate route catalog describes the broader HTML, Markdown, text, and XML publication surface. The API catalog and MCP server card connect these descriptions without implying editorial or operational write access.

- [OpenAPI](/openapi.json): Typed JSON and MCP contract.
- [Route catalog](/openapi-route-catalog.json): Multi-format public route catalog.
- [API catalog](/.well-known/api-catalog): RFC 9727 discovery linkset.
- [MCP server card](/.well-known/mcp): Hosted resources-only MCP discovery document.
- [MCP resource manifest](/mcp-readonly.json): Resource list, policies, and limits.
- [Payment capabilities](/agent-payments/payment-capabilities): Live paid product IDs, prices, x402 rails, preflight, and replay policy.


## Paid agent compute

Read payment-capabilities immediately before paying. Send the product request without PAYMENT-SIGNATURE first: validation, quota, and result preparation happen before the service returns a 402. Invalid, empty, and insufficient-evidence requests are not settled.

A sellable response returns PAYMENT-REQUIRED with either fixed-price USDC rails or one short-lived server-priced EURC, WETH, cbBTC, or wSOL rail. A buyer should enforce its own product, price, network, token, recipient, and spend policy before signing, then retry the byte-identical body. A settled result can be replayed with the original signed payment without another settlement.

### Discover live products

```bash
curl -sS https://newruntime.com/agent-payments/payment-capabilities
```

### Unsigned WETH payment preflight

```bash
curl -sS https://newruntime.com/agent-payments/research-bundle-v2/volatile/weth-base -H 'Content-Type: application/json' --data '{"query":"agent payment protocols","max_sources":5,"known_stable_ids":[]}'
```

### Unsigned research-delta preflight

```bash
curl -sS https://newruntime.com/agent-payments/research-bundle-v2 \
  -H 'Content-Type: application/json' \
  --data '{"query":"agent payment protocols","max_sources":5,"known_stable_ids":[]}'
```

### Unsigned prior-coverage preflight

```bash
curl -sS https://newruntime.com/agent-payments/prior-coverage \
  -H 'Content-Type: application/json' \
  --data '{"topic":"agent payment protocols","freshness_days":90}'
```


## MCP transport

The hosted MCP endpoint is POST /mcp using Streamable HTTP. It exposes resources and resource templates only. tools/list returns an empty list; publication, approval, deployment, administration, private data, and authenticated user operations are not available.

The enforced MCP limit is 60 requests per minute per observed client address, with a 256 KiB request-body limit and a five-second body timeout. A 429 response includes RateLimit fields and Retry-After.

### Discover MCP capabilities

```bash
curl -sS https://newruntime.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: server/discover' \
  --data '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"example","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'
```


## REST JSON limits

Public JSON routes enforce 120 requests per minute per observed client address. Successful responses include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy. A 429 response uses application/problem+json and adds Retry-After. HTML and Markdown publication pages are not part of this REST bucket.

### Inspect live REST limit fields

```bash
curl -sSI https://newruntime.com/topics.json | grep -Ei '^(ratelimit|retry-after|link):'
```


## Errors and versions

HTTP-layer errors use RFC 9457 application/problem+json when JSON is requested. MCP protocol failures remain JSON-RPC errors. Missing canonical pages can also return short HTML or Markdown recovery documents while preserving the original status code.

The public JSON contract is versioned through the OpenAPI info.version field and schema_version fields in records. Additive fields may appear without removing existing fields. Incompatible changes require a new contract or schema version.


## Deprecation and sunset policy

No public route or MCP protocol version is currently deprecated or scheduled for removal. Every public JSON response links this policy with rel=deprecation, but Deprecation and Sunset headers are intentionally absent until a concrete lifecycle event is scheduled.

A future incompatible removal will be announced here and in the substantive change feed. Affected responses will carry the RFC 9745 Deprecation header and a rel=deprecation Link. If an endpoint will become unavailable, it will also carry the RFC 8594 Sunset header. The normal migration window is at least 90 days between the announced deprecation date and sunset; urgent security, privacy, or legal risks may require a shorter window and will be documented explicitly.

- [Substantive changes](/changes.xml): Version and deprecation announcements.
- [Agent boundaries](/agents/): Reading order and non-mutation policy.