Blocksize Agentic Market Intelligence

Official9 toolsLive

by jf-cmyk · Python

Multi-venue VWAP, bid/ask, crypto FX, metals and equities with provenance receipts for AI agents

Blocksize MCP Agentic Payments (info.blocksize.mcp/agentic-payments)

The info.blocksize.mcp/agentic-payments MCP server provides live multi-asset market data for AI agents, including provenance, starter credits, and example integrations. It supports multiple integration layers: a public remote MCP discovery server, a paid HTTP API with x402 settlement or wallet-credit drawdown, and an Anthropic-safe MCP beta with authenticated read-only access and daily user credits.

🛠️ Key Features

Live multi-asset market data
Provenance for data
Starter credits
x402 settlement or wallet-credit drawdown (paid HTTP API)
Authenticated read-only market data with daily user credits (Anthropic-safe MCP beta)
Tool count: 8

🚀 Use Cases

Free symbol discovery, pricing inspection, and document search via the public remote MCP discovery server
Live market-data retrieval for AI agents
Anthropic-safe authenticated market-data access

⚡ Developer Benefits

Multiple integration endpoints (remote MCP, HTTP API, Anthropic-safe MCP)
Authenticated read-only option for Anthropic-safe MCP beta
Daily user credits support

⚠️ Limitations

Paid HTTP API is protected by x402 settlement or wallet-credit drawdown
Anthropic-safe MCP beta requires authentication and uses daily user credits

Topics

agentic-paymentsai-agentsbid-askfx-ratesmarket-datamcpmetals-apiprice-datareal-time-datax402crypto-vwap

Captured live from the server via tools/list.

search_pairs

Discover supported crypto, equity, FX, and metal symbols before using the paid HTTP API. Returns up to 50 catalog matches with asset class, available services, and pricing tier; it is free, read-only, and never returns live prices or starts payment.

Parameters2

query	string	required	Symbol, ticker, asset, or pair to search for, such as BTC, BTC-USD, ETH, AAPL, EURUSD, or XAUUSD.
asset_class	string	optional	Optional asset-class filter. Use all for the full catalog, crypto for digital assets, equity/equities for catalog-confirmed stock symbols such as AAPLXUSD, fx for currency pairs, or metal for metals.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Symbol, ticker, asset, or pair to search for, such as BTC, BTC-USD, ETH, AAPL, EURUSD, or XAUUSD.",
      "maxLength": 80,
      "minLength": 1,
      "type": "string"
    },
    "asset_class": {
      "default": "all",
      "description": "Optional asset-class filter. Use all for the full catalog, crypto for digital assets, equity/equities for catalog-confirmed stock symbols such as AAPLXUSD, fx for currency pairs, or metal for metals.",
      "enum": [
        "all",
        "crypto",
        "equity",
        "equities",
        "fx",
        "metal"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

list_instruments

List the supported instruments for one Blocksize service. This is free, read-only catalog metadata; it does not fetch live prices, create accounts, or start x402 payment.

Parameters3

service	string	optional	Blocksize service namespace to list: vwap for crypto VWAP pairs, bidask for shared bid/ask symbols including supported equities, fx for FX pairs, or metal for metals.
limit	integer	optional	Maximum instruments to return. Use offset to traverse the stable catalog without requesting the entire upstream array.
offset	integer	optional	Zero-based offset into the sorted instrument catalog.

Raw schema

{
  "type": "object",
  "properties": {
    "service": {
      "default": "vwap",
      "description": "Blocksize service namespace to list: vwap for crypto VWAP pairs, bidask for shared bid/ask symbols including supported equities, fx for FX pairs, or metal for metals.",
      "enum": [
        "vwap",
        "bidask",
        "fx",
        "metal"
      ],
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Maximum instruments to return. Use offset to traverse the stable catalog without requesting the entire upstream array.",
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset into the sorted instrument catalog.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

get_pricing_info

Inspect current direct x402 per-call prices, authenticated connector starter-credit costs, supported USDC settlement networks, and the account-plan contact path. This is free read-only metadata; it does not initiate payment.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_product_catalog

Inspect Blocksize raw data, supported equity ticker bid/ask, and premium agent-native workflow products, including starter-credit positioning, credit costs, suggested paid prices, endpoint templates, and upgrade path. This is free and read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

recommend_account_plan

Recommend a sales-assisted Blocksize account plan from expected live-call volume, team size, recurring use, and SLA needs. This is free and does not collect contact details, create an entitlement, or start a purchase.

Parameters4

expected_monthly_live_calls	integer	required	Expected live-data calls per month.
team_seats	integer	optional	People or service identities sharing access.
recurring_days_per_month	integer	optional	Days per month the workflow is expected to run.
needs_sla	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "expected_monthly_live_calls": {
      "description": "Expected live-data calls per month.",
      "maximum": 100000000,
      "minimum": 0,
      "type": "integer"
    },
    "team_seats": {
      "default": 1,
      "description": "People or service identities sharing access.",
      "maximum": 10000,
      "minimum": 1,
      "type": "integer"
    },
    "recurring_days_per_month": {
      "default": 0,
      "description": "Days per month the workflow is expected to run.",
      "maximum": 31,
      "minimum": 0,
      "type": "integer"
    },
    "needs_sla": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "expected_monthly_live_calls"
  ],
  "additionalProperties": false
}

get_workflow_endpoint

Build the exact paid HTTP endpoint, method, starter-credit cost, and example body for a premium Blocksize workflow. This is free and read-only; it does not fetch live data, charge credits, or start x402.

Parameters1

product

string

required

Premium Blocksize workflow product to prepare.

Raw schema

{
  "type": "object",
  "properties": {
    "product": {
      "description": "Premium Blocksize workflow product to prepare.",
      "enum": [
        "agent_market_brief",
        "pre_trade_sanity_check",
        "audit_grade_price_receipt",
        "multi_asset_macro_snapshot",
        "spend_controlled_market_monitor",
        "token_market_quality_indicator",
        "state_divergence_indicator",
        "solana_token_brief",
        "trader_alpha_pack"
      ],
      "type": "string"
    }
  },
  "required": [
    "product"
  ],
  "additionalProperties": false
}

get_market_data_endpoint

Build the exact x402-protected HTTP URL for one live market-data request. Returns method, URL, service notes, pricing docs, and next steps; it is read-only and does not fetch prices, charge a wallet, or submit payment.

Parameters2

service	string	required	Live HTTP data service to prepare: vwap for crypto VWAP, bidask for crypto pairs or catalog-confirmed equity symbols such as AAPLXUSD, state for AMM state price, vwap30m for latest completed 30-minute close, vwap24h for fixed 24-hour VWAP from the stream cache, fx for currency pairs, or metal for metals.
symbol	string	required	Exact pair or ticker to use in the paid HTTP URL, such as BTC-USD, AAPL, MSFT, NVDA, EURUSD, or XAUUSD. Use search_pairs first if unsure.

Raw schema

{
  "type": "object",
  "properties": {
    "service": {
      "description": "Live HTTP data service to prepare: vwap for crypto VWAP, bidask for crypto pairs or catalog-confirmed equity symbols such as AAPLXUSD, state for AMM state price, vwap30m for latest completed 30-minute close, vwap24h for fixed 24-hour VWAP from the stream cache, fx for currency pairs, or metal for metals.",
      "enum": [
        "vwap",
        "bidask",
        "state",
        "vwap30m",
        "vwap24h",
        "fx",
        "metal"
      ],
      "type": "string"
    },
    "symbol": {
      "description": "Exact pair or ticker to use in the paid HTTP URL, such as BTC-USD, AAPL, MSFT, NVDA, EURUSD, or XAUUSD. Use search_pairs first if unsure.",
      "maxLength": 80,
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "service",
    "symbol"
  ],
  "additionalProperties": false
}

search

Search Blocksize documentation and catalog metadata by keyword. This free read-only search returns document and instrument ids for fetch; it does not return live prices or start payment.

Parameters1

query

string

required

Documentation or catalog search query, such as pricing, quickstart, credits, x402, Solana, Base, BTC, or VWAP.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Documentation or catalog search query, such as pricing, quickstart, credits, x402, Solana, Base, BTC, or VWAP.",
      "maxLength": 120,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

fetch

Fetch one document or instrument guide returned by search. This is free, read-only content retrieval with no account, credential, payment, or live-price side effects.

Parameters1

string

required

Result id returned by the search tool, for example doc:pricing, doc:quickstart, or instrument:crypto:BTCUSD.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Result id returned by the search tool, for example doc:pricing, doc:quickstart, or instrument:crypto:BTCUSD.",
      "maxLength": 160,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

README.md11 KBView on GitHub

Blocksize Capital Agentic Payments

Institutional-grade market data for AI agents, with three integration surfaces:

Public remote MCP discovery server: free symbol discovery, pricing inspection, and document search
Paid HTTP API: live market data protected by direct x402 settlement
Authenticated Claude, Cursor, and OpenAI MCP connectors: read-only market data with a free starter allowance of 30,000 live-data credits every month, then subscriptions from EUR 49/month

Public URLs

Main Blocksize website: https://blocksize.info/?utm_source=agentic-widget&utm_medium=ai
Homepage: https://mcp.blocksize.info/
Remote MCP URL: https://mcp.blocksize.info/mcp/server/
Anthropic-safe MCP URL: https://mcp.blocksize.info/anthropic/mcp/
Claude connector docs: https://mcp.blocksize.info/claude-connector
MCP manifest: https://mcp.blocksize.info/mcp/manifest.json
OpenAPI JSON: https://mcp.blocksize.info/openapi.json
Swagger UI: https://mcp.blocksize.info/docs
Quickstart: https://mcp.blocksize.info/quickstart/remote-mcp
First live price quickstart: https://mcp.blocksize.info/quickstart/first-price
Prompt examples: https://mcp.blocksize.info/prompt-examples
Privacy policy: https://mcp.blocksize.info/privacy
Support: https://mcp.blocksize.info/support
MCP Registry metadata: https://mcp.blocksize.info/server.json
AI reader brief: https://mcp.blocksize.info/llms.txt
Sitemap: https://mcp.blocksize.info/sitemap.xml
Robots policy: https://mcp.blocksize.info/robots.txt
Data package catalog: https://mcp.blocksize.info/data-packages.json
Category hubs and claims boundary: https://mcp.blocksize.info/category-hubs.json
RWA market data hub: https://mcp.blocksize.info/rwa-market-data
Market data licensing hub: https://mcp.blocksize.info/market-data-licensing
Signed oracle feeds hub: https://mcp.blocksize.info/signed-oracle-feeds

Agent and Search Discoverability

Blocksize is optimized to be found for high-intent searches around real-time price data, market data APIs for AI agents, x402-paid data, and MCP market data discovery.

Canonical intent pages:

RWA market data API: https://mcp.blocksize.info/rwa-market-data
Market data licensing and redistribution: https://mcp.blocksize.info/market-data-licensing
Signed market data and oracle feeds: https://mcp.blocksize.info/signed-oracle-feeds
Market data API for AI agents: https://mcp.blocksize.info/market-data-api-for-ai-agents
Real-time price data API: https://mcp.blocksize.info/real-time-price-data-api
Crypto VWAP API: https://mcp.blocksize.info/crypto-vwap-api
Bid/ask price data API: https://mcp.blocksize.info/bid-ask-price-api
FX rates API: https://mcp.blocksize.info/fx-rates-api
Metals price API: https://mcp.blocksize.info/metals-price-api
x402 market data API: https://mcp.blocksize.info/x402-market-data-api
MCP market data server: https://mcp.blocksize.info/mcp-market-data-server
Accountless market data API: https://mcp.blocksize.info/accountless-market-data-api
Price data API examples: https://mcp.blocksize.info/price-data-api-examples
Market data API comparison: https://mcp.blocksize.info/market-data-api-comparison
Crypto market data API alternatives: https://mcp.blocksize.info/crypto-market-data-api-alternatives
Oracle data API for AI agents: https://mcp.blocksize.info/oracle-data-api-for-ai-agents

Recommended repository topics and listing keywords:

market-data, price-data, real-time-data, mcp, ai-agents, x402, crypto-vwap, bid-ask, fx-rates, metals-api, agentic-payments

Indexing checklist:

Submit https://mcp.blocksize.info/sitemap.xml in Google Search Console and Bing Webmaster Tools.
Request indexing for the homepage, data package catalog, and every canonical intent page above.
Use the MCP manifest, server.json, llms.txt, OpenAPI JSON, and data-packages.json as the canonical machine-readable citations in marketplaces, docs, and repo descriptions.
Use category-hubs.json for dated coverage states, rights boundaries, methodology, and citation instructions. Cataloged, candidate, and production-promoted coverage are intentionally separate states.

RWA claims boundary:

Blocksize already provides broad production coverage across its live market-data packages.
Separately, the reconciled 2026-07-30 RWA research snapshot contains 1,169 RWA.xyz source-asset rows and 3,438 token-listing rows (3,435 unique contract identities). Its lossless cross-venue matrix contains 2,139 canonical assets and 5,161 venue instruments; these are catalog and identity grains, not production-feed counts.
Candidate expansion lanes are not additional production feeds until their promotion gates pass.
Zero newly sourced third-party or onchain additions have completed the full RWA expansion-workflow promotion process. This figure does not describe or reduce existing Blocksize production coverage.
Hash-linked provenance receipts are not described as cryptographically signed unless a response includes a signature envelope with an algorithm, key identifier, digest, and signature.

Product Shape

1. Public remote MCP discovery server

The remote MCP server is meant for directory listings and fast evaluation in ChatGPT Developer Mode, Cursor, Claude MCP clients, Smithery, Glama, and other Streamable HTTP clients.

It exposes only read-only discovery tools:

search_pairs
list_instruments
get_pricing_info
get_product_catalog
recommend_account_plan
get_workflow_endpoint
get_market_data_endpoint
search
fetch

This public surface does not execute paid live market data calls directly.

2. Paid HTTP market data API

The paid HTTP API is the production data path for live access:

GET /v1/vwap/{pair}
GET /v1/bidask/{pair}
GET /v1/fx/{pair}
GET /v1/metal/{ticker}
GET /v1/batch

Free discovery endpoints:

GET /v1/coverage
GET /v1/search
GET /v1/instruments/{service}
GET /v1/samples/market-data?service=vwap&symbol=BTCUSD for a clearly synthetic value preview and attributed paid handoff
GET /health

/v1/search is paginated with limit and offset. Its total_matches field is the full match count for the searched catalogs; the default 50 is only the response page size and is unrelated to starter credits.

Payment modes:

signed x402 v2 payment per request via PAYMENT-SIGNATURE
starter credit drawdown through an authenticated Claude, Cursor, or OpenAI connector principal

New eligible authenticated users receive 30,000 free live data credits every calendar month (UTC), positioned as Start with 30,000 free live-data credits every month. The allowance is an evaluation and prototyping licence with required attribution; production commercial use requires a subscription. The number is configured once in FREE_TIER_MONTHLY_CREDITS (src/config.py) and every surface renders it from there. Raw caller-selected HTTP identity headers are disabled in production and cannot claim or spend credits. When the monthly allowance is exhausted, agents can use direct x402 payment, start a subscription trial at /go/free-trial (plans from EUR 49/month, see /go/pricing), or contact Blocksize sales about an Enterprise authenticated account plan.

Unit pricing is one list for both payment modes: 1 credit = $0.001 USDC, and every product costs the same number of credits in a connector as its x402 price (src/pricing_catalog.py):

Product	Credits	USDC (x402)
Core crypto: VWAP, bid/ask, state price, 30m and 24h VWAP	2	$0.002
Extended crypto: the same routes for long-tail pairs	4	$0.004
FX and metals	5	$0.005
Tokenized equities	8	$0.008
Pre-trade sanity check	100	$0.10
Market brief, price receipt, monitor evaluation	250	$0.25
Token quality, state divergence	500	$0.50
Macro snapshot, Solana token brief	1,000	$1.00
Trader alpha pack	2,500	$2.50

3. Anthropic-safe MCP beta

The Anthropic-safe MCP surface is mounted at /anthropic/mcp/ and exposes read-only tools only (the Cursor and OpenAI connectors expose the same set):

search_pairs
list_instruments
get_credit_balance
get_vwap
get_bid_ask
get_state_price
get_vwap_30m
get_vwap_24h
get_fx_rate
get_metal_price
get_market_brief
run_pre_trade_check
create_price_receipt
get_macro_snapshot
get_token_quality
get_state_divergence
get_solana_token_brief
get_trader_alpha_pack

Live market data tools use server-side free-tier credits keyed to authenticated user identity. The allowance is 30,000 credits per verified identity per calendar month (UTC), set by FREE_TIER_MONTHLY_CREDITS and shared by the Claude, Cursor, and OpenAI connectors. The legacy ANTHROPIC_DAILY_CREDITS, CURSOR_DAILY_CREDITS, and OPENAI_DAILY_CREDITS variables are ignored; per-user entitlement overrides for subscribers still apply.

For local beta testing, set ANTHROPIC_ENABLE_BETA_TOKENS=true and ANTHROPIC_BETA_TOKENS to a JSON object mapping random bearer tokens to user ids. For public Claude custom connectors, set ANTHROPIC_AUTH_PROVIDER=clerk, keep ANTHROPIC_ENABLE_BETA_TOKENS=false, and configure the Clerk env vars in .env.example. The Claude OAuth metadata endpoints are served at /.well-known/oauth-protected-resource/anthropic/mcp/ and /.well-known/oauth-authorization-server/anthropic/mcp.

4. Advanced local MCP

For builders who want the full tool surface inside a local MCP client, this repo also contains the advanced local MCP server in src/mcp_server.py.

That mode is intended for direct builder integrations and requires local credentials.

Coverage

Use GET /v1/coverage for current source-backed counts and qualification boundaries. The response separates enabled live discovery namespaces, decision-grade canonical RWA identities, and research/manual-verification coverage. Namespace and venue-row counts overlap and must not be summed as a unique-instrument total.

Local Development

bash

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

Run the HTTP server:

bash

uvicorn src.resource_server:app --port 8402

Run the advanced local MCP server:

bash

python -m src.mcp_server

Tests

bash

.venv/bin/python -m pytest tests/ -q

Listing Artifacts

Official registry file: server.json
Smithery metadata: docs/smithery_manifest.json
Claude submission packet: docs/gtm/claude_connector_submission.md
Claude plugin package: claude-plugin/blocksize-market-data
Claude plugin submission packet: docs/gtm/claude_plugin_submission/README.md
Internal submission runbook: docs/gtm/directory_listing_runbook.md

License

MIT

Install

Tools (9)

search_pairslist_instrumentsget_pricing_infoget_product_catalogrecommend_account_planget_workflow_endpointget_market_data_endpointsearch

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.blocksize.info/mcp/server/?utm_source=mcp-registry

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentic-payments": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.blocksize.info/mcp/server/?utm_source=mcp-registry"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Blocksize MCP Agentic Payments (info.blocksize.mcp/agentic-payments)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_pairs

list_instruments

get_pricing_info

get_product_catalog

recommend_account_plan

get_workflow_endpoint

get_market_data_endpoint

search

fetch

Blocksize Capital Agentic Payments

Public URLs

Agent and Search Discoverability

Product Shape

1. Public remote MCP discovery server

2. Paid HTTP market data API

3. Anthropic-safe MCP beta

4. Advanced local MCP

Coverage

Local Development

Tests

Listing Artifacts

License

Install

Remote endpoint

Related servers