# ShadowGraph Machine Intelligence

ShadowGraph is an agent-first, pay-per-call global causal market intelligence service.

Base URL: https://shadowgraph-live.floot.app
MCP endpoint: https://shadowgraph-live.floot.app/_api/mcp
A2A endpoint: https://shadowgraph-live.floot.app/_api/a2a
A2A Agent Card: https://shadowgraph-live.floot.app/.well-known/agent-card.json
REST paid endpoint: https://shadowgraph-live.floot.app/_api/machine/intelligence
Free agent preview: https://shadowgraph-live.floot.app/_api/agent_preview
OpenAPI: https://shadowgraph-live.floot.app/openapi.json
MCP registry manifest: https://shadowgraph-live.floot.app/server.json

## Global coverage

- Türkiye: KAP official disclosures + public procurement radar + BIST market layer
- United States: SEC EDGAR official company filings
- European Union: TED official procurement Search API
- Global: Yahoo cross-asset/company market data
- Global infrastructure: PeeringDB facilities and internet exchanges across major hubs
- Global news: thematic AI, telecom, energy, banking and logistics feeds
- Relationship graph: persistent PostgreSQL-backed evidence/inference graph
- Price-lag detector: 6-month daily log returns, 1-5 trading-day lag scan, zero-lag improvement, split-sample stability and sample-size scoring
- Commercial lead engine: evidence-backed candidate supplier opportunities from KAP/public procurement/TED

Free machine-readable endpoints:
- /_api/global_official
- /_api/global_news
- /_api/global_markets
- /_api/global_infra
- /_api/graph
- /_api/price_lag
- /_api/leads

## MCP tools

- shadowgraph_free_preview — free live preview
- shadowgraph_global_snapshot — $0.50 per call (recommended first paid call)
- shadowgraph_market_signal — $0.75 per call
- shadowgraph_procurement_opportunity — $1.00 per call
- shadowgraph_global_brief — $2.50 per call
- shadowgraph_deep_research — $5.00 per call
- shadowgraph_hidden_chain — $0.50 per call
- shadowgraph_alpha — $0.75 per call
- shadowgraph_opportunity — $1.00 per call
- shadowgraph_service_info — free

MCP transport: Streamable HTTP.
Supported protocol versions: 2026-07-28 and 2025-11-25.

Modern discovery starts with JSON-RPC method server/discover and then tools/list.
For MCP 2026-07-28 include MCP-Protocol-Version and Mcp-Method headers.
For tools/call also include Mcp-Name.

## REST modes

GET /_api/agent_preview

Use this free endpoint first to inspect current live coverage, graph size and the top measured price-lag relationship.

POST /_api/machine/intelligence

JSON:
{"mode":"hidden_chain"}
{"mode":"alpha"}
{"mode":"opportunity"}
{"mode":"global_brief"}
{"mode":"deep_research"}

## Payment

Paid calls use HTTP 402 Machine Payments Protocol with Stripe.
An unpaid request receives:
WWW-Authenticate: Payment ...

Fulfill the payment challenge, retry the identical request with:
Authorization: Payment <credential>

A successful paid response includes:
Payment-Receipt: <receipt>

Current prices:
hidden_chain: $0.50
alpha: $0.75
opportunity: $1.00
global_brief: $2.50
deep_research: $5.00

## What the service returns

ShadowGraph combines official corporate disclosures, public procurement, infrastructure, news and cross-market data into causal-chain, relative-pricing and commercial-opportunity inference across regions. Inferred graph edges, lead/lag relationships and commercial leads are hypotheses/candidates, not proof of causation, contracts, bidding activity or guaranteed investment returns.

## Discovery

ShadowGraph is listed on MPPScan under its public origin:
https://shadowgraph-live.floot.app

ShadowGraph is also published as an active remote server in the Official MCP Registry:
app.floot.shadowgraph-live/shadowgraph

ShadowGraph also publishes an A2A v1.0 Agent Card:
https://shadowgraph-live.floot.app/.well-known/agent-card.json

Use the MCP endpoint directly when an MCP client is available. Otherwise use the OpenAPI/REST endpoint.