Developer Docs

FC API docs for reports, risk, and decision workflows.

Use the console to sign in, review reports, and access the latest FC docs. Production API access is managed through your FC account workflow.

Reports

Search report metadata, fetch report detail, and connect reports into internal workflows.

Risk

Read country risk, action cards, and country guides from the same monitored dataset.

Decisioning

Use agent workflows and the simulator to support review, approvals, and scenario analysis.

Access

Current access model

1. Open Console and sign in.

2. Use the in-app docs and reports library to explore routes and sample responses.

3. Account-based API access is managed through your FC setup workflow.

Open Console View In-App Docs

What to do first

Open Console

Open Docs

Review reports endpoints

Connect your workflow

MCP Server

Connect your AI assistant directly to FC using the fc-mcp server. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Country Risk

Query all country risk scores and top policy cards in one call.

MOFCOM Guides

Full-text search and read 46+ country trade guides extracted from MOFCOM PDFs.

Action Cards & Packs

Search live policy action cards and retrieve your decision packs and scenarios.

1. Get your API token

Get Token in Console

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "fc": {
      "command": "npx",
      "args": ["-y", "fc-mcp"],
      "env": { "FC_API_KEY": "YOUR_TOKEN" }
    }
  }
}

Cursor / Claude Code / Windsurf

// .cursor/mcp.json  or  .claude/settings.json
{
  "mcpServers": {
    "fc": {
      "command": "npx",
      "args": ["-y", "fc-mcp"],
      "env": { "FC_API_KEY": "YOUR_TOKEN" }
    }
  }
}

Python

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
import asyncio, os

params = StdioServerParameters(
    command="npx", args=["-y", "fc-mcp"],
    env={"FC_API_KEY": os.environ["FC_API_KEY"]},
)
async def main():
    async with stdio_client(params) as (r, w):
        async with ClientSession(r, w) as s:
            await s.initialize()
            result = await s.call_tool("fc_country_risk_list", {})
            print(result.content[0].text)
asyncio.run(main())

Available tools

fc_country_risk_listAll countries with risk scores and top policy cards

fc_country_guideFull guide: snapshot, latest updates, patterns, recommendations

fc_trade_docs_searchFull-text search over 46+ MOFCOM country guides

fc_trade_doc_readFull section content of a specific guide by slug

fc_action_cards_searchPolicy cards filtered by country, HS code, domain, or category

fc_decision_packs_listYour decision packs with status and HS codes

fc_scenarios_listYour saved trade shock scenarios

Quickstart

Open the FC console and sign in.
Browse reports in Reports.
Use GET /api/docs/trade to read report metadata.
Use GET /api/country-risk and GET /api/action-cards for monitoring.
Use POST /api/simulator/analyze for scenario analysis.

Reports API

GET

/api/docs/trade

List FC reports with optional query filters.

GET /api/docs/trade
GET /api/docs/trade?q=US
GET /api/docs/trade?country=USA
GET /api/docs/trade?tag=customs

GET

/api/docs/trade/[slug]

Fetch one FC report by slug.

GET /api/docs/trade/mofcom-united-states-trade-guide-en

Risk And Cards

/api/action-cards

Read action cards with filtering by country, severity, and topic.

/api/country-risk

Return country risk rows with expanded top cards and risk scores.

/api/country-guide

Return country-level summary objects for quick operational review.

Decisioning

/api/agent/run

Process one policy record into draft structured outputs and downstream review artifacts.

/api/agent/run-pending

Batch-process pending rows into action cards and connected workflows.

Simulator

POST

/api/simulator/analyze

Run scenario analysis using existing action cards and monitored country data.

{
  "countries": "CHN,USA",
  "hs_codes": "1001,1002",
  "objective": "Reduce customs disruption risk",
  "product": "Wheat imports",
  "current_incoterm": "FOB",
  "analysis_depth": "standard"
}