# AcqPath — RSL rights preflight

> Observed declaration evidence before AI input, RAG indexing, training or search. Reports are not licenses or legal clearance.

MCP: https://api.getacqpath.com/mcp (Streamable HTTP). Paid report delivery uses HTTP x402 outside MCP.
Fresh 0.02 USDC; deep 0.05 USDC, observed 2026-09-10T13:40:17.531Z. Verify live capabilities and signed quote.
UNKNOWN and unsupported inputs do not authorize ingestion. Private claims and signatures stay outside model context. npm is unpublished.

## Integration
- [Check declared AI usage rights before ingestion.](https://developers.getacqpath.com/): RSL declaration evidence for supported URLs. Use it before model input, RAG indexing, training or search. Get a timestamped signed report through HTTP x402.
- [From supported URL to verified rights evidence](https://developers.getacqpath.com/quickstart): Start with a free capability read. A fresh report is 0.02 USDC and a deep report is 0.05 USDC as observed; the signed quote controls the exact purchase.
- [Connect AcqPath to an MCP client](https://developers.getacqpath.com/connect): Remote Streamable HTTP at api.getacqpath.com/mcp. No seller API key is required for public capabilities and quote preparation.
- [Rights evidence in an agent workflow](https://developers.getacqpath.com/integrations): Choose the purpose, preserve evidence and keep the ingestion decision in your application. Framework-neutral examples use the same bounded buyer adapter.
- [Coverage, decisions and limitations](https://developers.getacqpath.com/scope): Explicit origin coverage and conservative decisions. Missing or unsupported evidence never becomes permission.
- [0.02 USDC fresh. 0.05 USDC deep.](https://developers.getacqpath.com/pricing): Pay per prepared rights report on Base. Current observed prices stay unchanged; verify the signed quote before authorizing a purchase.
- [Resume evidence delivery without a new payment](https://developers.getacqpath.com/recovery): A network failure is not a reason to create another order or signature. Preserve the original private checkpoint.
- [The AcqPath HTTP x402 purchase contract](https://developers.getacqpath.com/http-x402): Quote first, private claim second, signed payment third. This is a multi-step report flow, not a generic one-call paid MCP tool.
- [Check declarations before AI input](https://developers.getacqpath.com/ai-input): For summarization, research agents and model context: evaluate observed RSL declarations for the actual selected source.
- [RSL evidence before RAG ingestion](https://developers.getacqpath.com/rag-ingestion): Preflight supported URLs before corpus ingestion and preserve signed rights evidence with your provenance.
- [Check indexing and search declarations](https://developers.getacqpath.com/indexing-search): Evaluate declared restrictions before adding supported content to an index or search workflow.
- [Check AI training declarations](https://developers.getacqpath.com/training): Get dated evidence of declared AI training restrictions for selected supported resources.
- [Can I crawl this URL? Keep crawl and AI use separate.](https://developers.getacqpath.com/crawl): AcqPath does not offer a paid crawl-permission product. Evaluate actual downstream AI input, indexing, training or search declarations separately.

## Machine-readable assets
- [Agent skill](https://developers.getacqpath.com/SKILL.md)
- [OpenAPI subset](https://developers.getacqpath.com/openapi.json)
- [Service metadata](https://developers.getacqpath.com/service.json)
- [Discovery profile](https://developers.getacqpath.com/.well-known/acqpath-distribution.json)
- [Capabilities snapshot](https://developers.getacqpath.com/capabilities.json)
- [Pricing snapshot](https://developers.getacqpath.com/pricing.json)
- [MCP configuration](https://developers.getacqpath.com/mcp-config.json)
- [Input examples](https://developers.getacqpath.com/examples.json)
- [Documented tools](https://developers.getacqpath.com/mcp-tools.json)
- [Full reference](https://developers.getacqpath.com/llms-full.txt)

## Full integration reference

# Check declared AI usage rights before ingestion.
Canonical: https://developers.getacqpath.com/

RSL declaration evidence for supported URLs. Use it before model input, RAG indexing, training or search. Get a timestamped signed report through HTTP x402.

## Connect once. Keep payment in your application.

MCP endpoint: https://api.getacqpath.com/mcp

MCP exposes capabilities and quote preparation. A generic chat host does not complete payment. Keep private quote claims outside model context.

```text
{
  "mcpServers": {
    "acqpath": {
      "url": "https://api.getacqpath.com/mcp"
    }
  }
}
```

- [MCP configuration examples](https://developers.getacqpath.com/connect)
- [HTTP/x402 quickstart](https://developers.getacqpath.com/quickstart)

## Choose the actual use

AI input: ai-input. Indexing and RAG corpus preparation: ai-index. Training: ai-train. Search: search.

RAG may need both ai-index and ai-input. Crawl permission and robots.txt checks are separate.

- [AI input](https://developers.getacqpath.com/ai-input)
- [RAG / ingestion](https://developers.getacqpath.com/rag-ingestion)
- [Indexing / search](https://developers.getacqpath.com/indexing-search)
- [Training](https://developers.getacqpath.com/training)
- [Crawler boundary](https://developers.getacqpath.com/crawl)

## Know the scope before buying

Current observed origins: medium.com, theguardian.com, rslstandard.org and rslcollective.org. An origin match does not guarantee usable declarations for its pages.

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

- [Current API capabilities](https://api.getacqpath.com/v1/capabilities)
- [Coverage and decision meanings](https://developers.getacqpath.com/scope)

# From supported URL to verified rights evidence
Canonical: https://developers.getacqpath.com/quickstart

Start with a free capability read. A fresh report is 0.02 USDC and a deep report is 0.05 USDC as observed; the signed quote controls the exact purchase.

## 1. Check origin coverage and purpose

GET the current capability list before any quote. Use rights.preflight.v1 only when enabled.

Pass canonical HTTPS URLs without credentials, query, fragment, nonstandard port or encoded slash. Exact origin membership matters.

```text
GET https://api.getacqpath.com/v1/capabilities
```

- [Read-only JavaScript example](https://developers.getacqpath.com/examples/read-only.mjs)
- [Read-only Python example](https://developers.getacqpath.com/examples/read-only.py)

## 2. Prepare one quote when evidence is needed

Quotes perform no financial settlement but can fetch metadata and consume quota. Do not create quotes for speculative discovery or every search result.

The example origin is supported at the observation time; this URL is illustrative and has not been shown to yield a purchasable declaration. Keep the returned claim private.

```text
POST https://api.getacqpath.com/v1/rights/quote
Content-Type: application/json

{
  "resource": "https://rslstandard.org/",
  "purpose": "ai-input",
  "user_class": "commercial",
  "tier": "fresh",
  "max_total_micro": "20000"
}
```

## 3. Handle unavailable and UNKNOWN

available:false with NO_VERIFIABLE_DECLARATION has no report fee. A discovered but unsupported declaration can produce a purchasable UNKNOWN report. Inspect the preview and decide whether diagnostic evidence is worth buying.

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

## 4. Buy with bounded, verified authorization

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

The buyer-side client pins Base, USDC, recipient and maximum amount; verifies signed offer, report, settlement receipt and delivery binding; and requires durable checkpoint persistence. A verified receipt is not independent blockchain finality.

- [JavaScript payment adapter](https://developers.getacqpath.com/examples/evidence-gate.mjs)
- [TypeScript use cases](https://developers.getacqpath.com/examples/workflows.ts)
- [Full HTTP flow](https://developers.getacqpath.com/http-x402)

## 5. Reuse the integration safely

Use one stable logical purchase ID for one resource/purpose/context request. Resume an existing checkpoint after a timeout. Start a new purchase only for a deliberately new evidence request.

The npm package is unpublished. Use the client source from this repository; no npm install instruction is required.

```text
git clone https://github.com/reflectme-source/acqpath-distribution.git
cd acqpath-distribution
node examples/read-only.mjs
```

- [Source repository](https://github.com/reflectme-source/acqpath-distribution)
- [Recovery decisions](https://developers.getacqpath.com/recovery)

# Connect AcqPath to an MCP client
Canonical: https://developers.getacqpath.com/connect

Remote Streamable HTTP at api.getacqpath.com/mcp. No seller API key is required for public capabilities and quote preparation.

## Cursor / generic mcpServers configuration

Use a client that supports remote Streamable HTTP. Keep quote results containing claim_token in a private application path, not a shared conversation.

```text
{
  "mcpServers": {
    "acqpath": {
      "url": "https://api.getacqpath.com/mcp"
    }
  }
}
```

## VS Code mcp.json

Add the remote server to a workspace MCP configuration after reviewing its tool permissions.

```text
{
  "servers": {
    "acqpath": {
      "type": "http",
      "url": "https://api.getacqpath.com/mcp"
    }
  }
}
```

## Claude Code

This registers the public endpoint. It does not authorize a wallet or implement paid HTTP redemption.

```text
claude mcp add --transport http acqpath https://api.getacqpath.com/mcp
```

## Tools and payment boundary

acqpath_capabilities: read current capability metadata. acqpath_rights_quote: prepare a report quote; may fetch metadata and consume quota; returns a sensitive claim.

The runtime also lists a disabled legacy provider-routing tool. Exclude acqpath_quote from the integration allowlist. The distribution metadata cannot change the core tools/list response.

Initialize and list tools to test the connection. Only call quote when the selected supported resource actually needs evidence.

- [Documented tool schemas](https://developers.getacqpath.com/mcp-tools.json)
- [HTTP payment and verification](https://developers.getacqpath.com/http-x402)

# Rights evidence in an agent workflow
Canonical: https://developers.getacqpath.com/integrations

Choose the purpose, preserve evidence and keep the ingestion decision in your application. Framework-neutral examples use the same bounded buyer adapter.

## RAG and ingestion gates

Call before adding selected supported URLs to a corpus. Use ai-index for indexing, then separately ai-input for model context if needed. UNKNOWN or unsupported results hold ingestion.

- [RAG / ingestion guide](https://developers.getacqpath.com/rag-ingestion)
- [TypeScript workflows](https://developers.getacqpath.com/examples/workflows.ts)

## Research agents

Evaluate selected sources before summarization or model context with ai-input. Store the verified resource, purpose and evaluation time alongside provenance. Do not quote every search result.

- [AI input guide](https://developers.getacqpath.com/ai-input)

## Crawlers

Crawl authorization is separate. Use your robots/access policy before retrieval, then the actual downstream paid purpose before ingestion. Do not send crawl as a paid quote purpose.

- [Crawler boundary](https://developers.getacqpath.com/crawl)

## One reusable buyer adapter

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

The examples expose no wallet key interface and make no payment when imported or run in read-only mode. Supply your own bounded signer only in a private buyer application.

- [JavaScript adapter](https://developers.getacqpath.com/examples/evidence-gate.mjs)
- [Framework-neutral workflow contract](https://developers.getacqpath.com/examples/workflow.json)
- [Example guide](https://github.com/reflectme-source/acqpath-distribution/blob/main/examples/README.md)

# Coverage, decisions and limitations
Canonical: https://developers.getacqpath.com/scope

Explicit origin coverage and conservative decisions. Missing or unsupported evidence never becomes permission.

## Observed coverage

Observed 2026-09-10T13:40:17.531Z: medium.com, theguardian.com, rslstandard.org, rslcollective.org. Re-read live capabilities; this is a dated snapshot.

Coverage accepts an exact origin, not every subdomain. A page on an allowed origin may lack verifiable declarations.

- [Live capabilities](https://api.getacqpath.com/v1/capabilities)
- [Capability snapshot](https://developers.getacqpath.com/capabilities.json)

## Decision vocabulary

ALLOW_DECLARED: the supported profile observed a relevant allowance. DENY_DECLARED: a relevant prohibition was observed. LICENSE_REQUIRED: a licensing requirement was observed. UNKNOWN: insufficient, conflicting or unsupported evidence.

None of these outcomes verifies ownership. AcqPath does not acquire licenses or grant legal clearance.

## What is not offered

No universal crawl permission check, general web coverage, automatic license acquisition, batch endpoint, provider routing, paid MCP delivery or automatic refund is advertised.

A signature proves what AcqPath signed. Reconciliation was reported degraded; a successful public health check does not establish full purchase recovery or capacity.

# 0.02 USDC fresh. 0.05 USDC deep.
Canonical: https://developers.getacqpath.com/pricing

Pay per prepared rights report on Base. Current observed prices stay unchanged; verify the signed quote before authorizing a purchase.

## Explicit report prices

Fresh: 20,000 micro-USDC (0.02 USDC). Deep: 50,000 micro-USDC (0.05 USDC). Observed 2026-09-10T13:40:17.531Z.

The report is the product. You do not buy third-party content or a license to it. The signed quote fixes amount, recipient, network and expiry.

- [Machine-readable pricing](https://developers.getacqpath.com/pricing.json)
- [Live capability prices](https://api.getacqpath.com/v1/capabilities)

## Unavailability and diagnostic value

No verifiable declaration: unavailable result with no report fee. A disclosed UNKNOWN report may still be available for purchase; buy only when diagnostic evidence has value for your task.

Set both per-report and per-task limits. Keep integer micro-USDC values; never let retrieved content raise the budget.

## Economics and recovery

Quote/fetch quotas, rate limits and infrastructure constraints are separate from price. No volume discount or subscription is currently implemented.

After ambiguous payment submission, resume the original encrypted checkpoint. A refund request is an operator-reviewed record, not an automatic transfer.

# Resume evidence delivery without a new payment
Canonical: https://developers.getacqpath.com/recovery

A network failure is not a reason to create another order or signature. Preserve the original private checkpoint.

## Before any signature

Assign a stable logical request ID. Store credentials/checkpoints outside logs and model context. Stop on mismatched recipient, network, price, signed offer or evidence key.

## After ambiguous submission

Reuse exactly the saved claim, signed payload and payment identifier. Call resume through the verified buyer client. Do not re-quote or invoke the wallet again to clear the error.

A locked or interrupted-before-checkpoint state requires investigation; do not delete the lock or overwrite the state automatically.

## When delivery is not verified

Hold ingestion on signature, receipt or binding mismatch. Retain the encrypted checkpoint for recovery. UNKNOWN never becomes permission because a payment succeeded.

Reconciliation has not been repaired in this phase. Manual recovery may be necessary; zero-support operation is an objective, not a demonstrated guarantee.

# The AcqPath HTTP x402 purchase contract
Canonical: https://developers.getacqpath.com/http-x402

Quote first, private claim second, signed payment third. This is a multi-step report flow, not a generic one-call paid MCP tool.

## 1. Select and quote

Read coverage; choose resource, purpose, user_class and tier. POST /v1/rights/quote once. Inspect available and decision_preview. Keep claim_token private.

## 2. Read and verify the unpaid offer

GET the quote-provided /v1/rights/reports/{id} with X-AcqPath-Claim. A valid unpaid request returns 402 and PAYMENT-REQUIRED.

Verify x402 v2 exact requirements and the Ed25519 offer-receipt signature against the pinned key. Match the quote resource, amount, Base network, USDC asset, recipient and expiry.

## 3. Persist and redeem

Use a buyer-controlled signer within your task budget. Persist an encrypted checkpoint containing the exact authorization before submitting it.

GET the same redeem URL with X-AcqPath-Claim and PAYMENT-SIGNATURE. Verify signed report contents, context, settlement receipt and delivery-proof bindings.

- [Verified buyer implementation](https://github.com/reflectme-source/acqpath-distribution/tree/main/packages/rights-client)
- [JavaScript integration adapter](https://developers.getacqpath.com/examples/evidence-gate.mjs)

## 4. Return evidence, not an authorization shortcut

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

On ambiguity, resume the original checkpoint without new quote or signature. For refund requests use the documented operator-reviewed flow only after a deliberate decision; it does not send money automatically.

- [Public-flow OpenAPI](https://developers.getacqpath.com/openapi.json)
- [Workflow JSON](https://developers.getacqpath.com/examples/workflow.json)

# Check declarations before AI input
Canonical: https://developers.getacqpath.com/ai-input

For summarization, research agents and model context: evaluate observed RSL declarations for the actual selected source.

## When to call

Use ai-input before placing source content into the model context. There is no separate summarize purpose or blanket permission guarantee.

Deduplicate by canonical URL, purpose and context. Request new evidence only when your freshness policy requires it.

## Input and purchase

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

```text
{
  "resource": "https://rslstandard.org/",
  "purpose": "ai-input",
  "tier": "fresh",
  "user_class": "commercial",
  "max_total_micro": "20000"
}
```

## Decision and retry

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

Verify all evidence and use one durable purchase ID. Resume an existing checkpoint after ambiguity; never create a replacement charge blindly.

- [Connect MCP](https://developers.getacqpath.com/connect)
- [Reusable TypeScript examples](https://developers.getacqpath.com/examples/workflows.ts)
- [HTTP quickstart](https://developers.getacqpath.com/quickstart)

# RSL evidence before RAG ingestion
Canonical: https://developers.getacqpath.com/rag-ingestion

Preflight supported URLs before corpus ingestion and preserve signed rights evidence with your provenance.

## When to call

RAG is a workflow, not a purpose enum. Indexing and model input can require separate ai-index and ai-input evaluations.

Deduplicate by canonical URL, purpose and context. Request new evidence only when your freshness policy requires it.

## Input and purchase

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

```text
{
  "resource": "https://rslstandard.org/",
  "purpose": "ai-index",
  "tier": "fresh",
  "user_class": "commercial",
  "max_total_micro": "20000"
}
```

## Decision and retry

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

Verify all evidence and use one durable purchase ID. Resume an existing checkpoint after ambiguity; never create a replacement charge blindly.

- [Connect MCP](https://developers.getacqpath.com/connect)
- [Reusable TypeScript examples](https://developers.getacqpath.com/examples/workflows.ts)
- [HTTP quickstart](https://developers.getacqpath.com/quickstart)

# Check indexing and search declarations
Canonical: https://developers.getacqpath.com/indexing-search

Evaluate declared restrictions before adding supported content to an index or search workflow.

## When to call

Use ai-index for indexing and search for search. Do not substitute one purpose for the other.

Deduplicate by canonical URL, purpose and context. Request new evidence only when your freshness policy requires it.

## Input and purchase

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

```text
{
  "resource": "https://rslstandard.org/",
  "purpose": "ai-index",
  "tier": "fresh",
  "user_class": "commercial",
  "max_total_micro": "20000"
}
```

## Decision and retry

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

Verify all evidence and use one durable purchase ID. Resume an existing checkpoint after ambiguity; never create a replacement charge blindly.

- [Connect MCP](https://developers.getacqpath.com/connect)
- [Reusable TypeScript examples](https://developers.getacqpath.com/examples/workflows.ts)
- [HTTP quickstart](https://developers.getacqpath.com/quickstart)

# Check AI training declarations
Canonical: https://developers.getacqpath.com/training

Get dated evidence of declared AI training restrictions for selected supported resources.

## When to call

Use ai-train before including selected source content in training preparation. AcqPath does not audit an entire dataset or acquire training licenses.

Deduplicate by canonical URL, purpose and context. Request new evidence only when your freshness policy requires it.

## Input and purchase

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

```text
{
  "resource": "https://rslstandard.org/",
  "purpose": "ai-train",
  "tier": "fresh",
  "user_class": "commercial",
  "max_total_micro": "20000"
}
```

## Decision and retry

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

Verify all evidence and use one durable purchase ID. Resume an existing checkpoint after ambiguity; never create a replacement charge blindly.

- [Connect MCP](https://developers.getacqpath.com/connect)
- [Reusable TypeScript examples](https://developers.getacqpath.com/examples/workflows.ts)
- [HTTP quickstart](https://developers.getacqpath.com/quickstart)

# Can I crawl this URL? Keep crawl and AI use separate.
Canonical: https://developers.getacqpath.com/crawl

AcqPath does not offer a paid crawl-permission product. Evaluate actual downstream AI input, indexing, training or search declarations separately.

## Before crawling

Respect your crawler access, robots and site policy before retrieval. A rights report is not a robots.txt validator, permission grant or access-control bypass.

The existing free XML inspection path accepts a legacy crawl purpose, but it inspects supplied XML only; it does not fetch the URL and cannot establish usage rights.

## Before ingestion

Once your crawler has a legitimately selected supported source, choose the actual paid purpose: ai-input, ai-index, ai-train or search.

Check live coverage → prepare one bounded quote → inspect availability/preview → verify the signed offer → obtain buyer-controlled payment authorization → persist the encrypted checkpoint → redeem and verify report, receipt and delivery binding. After ambiguity, resume the same checkpoint; never sign a replacement payment blindly.

## Hold uncertain sources

UNKNOWN, missing declarations, unsupported origins and LICENSE_REQUIRED do not authorize use. A report records observed RSL declarations; it is not a license or legal clearance.

- [Indexing / search](https://developers.getacqpath.com/indexing-search)
- [RAG ingestion](https://developers.getacqpath.com/rag-ingestion)
- [Documented XML inspection](https://developers.getacqpath.com/openapi.json)