Give your agent official records to check against
Factline is a set of MCP servers and a REST API. Your agent calls it when its user asks about a person, company, Dutch address or car, and answers with official data and a source line it can quote. Pay per call in USDC (x402) with no account, or use an API key.
One minute
Add the server, no key or wallet needed. Claude Code:
claude mcp add --transport http factline-kyc https://factline.dev/mcp/kyc
Codex CLI:
codex mcp add factline-kyc --url https://factline.dev/mcp/kyc
Then ask: is Acme Trading Ltd on a sanctions list? The first 5 checks a day are free.
Every paid answer carries a signed receipt. See a signed receipt.
Skills
Skills make your agent run the checks on its own whenever the situation comes up. Install all five:
npx skills add factline-dev/factline-skills
Or in Claude Code:
/plugin marketplace add factline-dev/factline-skills /plugin install factline@factline
verify-before-paying: check a supplier invoice or a changed IBAN before money leavescheck-a-counterparty: registers, sanctions and PEP for a new customer or suppliercheck-a-chinese-supplier: USCC, sanctions, Entity List and UFLPA check for a supplier in Chinabefore-an-x402-payment: allow, review or deny a 402 payment before it is signed (free)dutch-address-and-vehicle-facts: official facts for a Dutch address, postcode or licence plate
Tell your agent when to use it
Installing the server is not enough: the agent has to know when to call it. Add this line to AGENTS.md (Codex, Cursor and others) or CLAUDE.md (Claude Code). It is read every session.
Counterparty, invoice and x402 payee checks: use the factline MCP server (https://factline.dev/mcp/kyc?via=agents-md) before any payment or supplier/customer onboarding step, and keep the receipt URL in the file.
For Codex, the server in ~/.codex/config.toml:
[mcp_servers.factline] url = "https://factline.dev/mcp/kyc?via=codex-config"
On a schedule
A check at onboarding is the start. Screening has to keep running: sanctions lists change every week, suppliers change bank details. Let your agent come back on its own. Watch a counterparty once (watch_30_days, or POST /v1/watch with a key), then give a scheduled task one prompt:
Every Monday at 09:00: call the Factline tool watch_alerts with my token (or API key). If there are alerts, tell me what changed for each name or company and what I should do. If there are none, reply in one line: all clear.
This works in Claude scheduled tasks (Claude Code, Claude Cowork), Codex automations and ChatGPT tasks, with the Factline MCP server connected (factline.dev/mcp/kyc). Without a schedule, key holders get the same alerts by email and a Monday all-clear.
Pick a server
| URL | For | Tools |
|---|---|---|
https://factline.dev/mcp/kyc | Companies, people and agent payments | one-call company check, x402 payee check and seller health, bulk screening, 30-day watches, self-hosted wallet evidence, ECB rates and EU law (free), sanctions, PEP, one-call KYC, company registers (10 countries), Dutch insolvency, EU VAT, EORI, IBAN, domain, email, phone, EU tenders |
https://factline.dev/mcp/nl | Dutch homes and places | address facts and reports, neighbourhoods, crime, flood risk, rent check, house prices, energy labels, schools, address lookup and batch |
https://factline.dev/mcp/vehicles | Dutch vehicles | licence plate checks, APK expiry, recalls, odometer verdict, model reliability, plate comparison |
https://factline.dev/mcp | Everything | all of the above in one server (44 tools) |
https://factline.dev/mcp/claude | Claude (directory), free only | free read-only tools: Dutch addresses, neighbourhoods, schools, plates, car models, ECB rates, EU law, x402 sellers |
https://factline.dev/mcp/chat | Chat assistants, free only | the free address, neighbourhood, plate, car model and schools tools; no payment needed |
Smaller servers help models pick the right tool. All use Streamable HTTP and need no login. In the official MCP Registry as io.github.snefhew/factline, factline-kyc, factline-nl and factline-vehicles.
Paying
Works on the first call in Claude, ChatGPT, Codex and Cursor: the first 5 paid checks a day are free, over MCP and as plain GET requests, with no wallet, key or sign-up. The answer says how many are left; after that the agent can get a starter key itself, no email needed.
- No account: paid tools answer with an x402 payment request (USDC on Base or Solana). Agents with an x402 wallet pay per call, from USD 0.001; bulk screening is metered per name (x402
upto). Failed calls are not charged, and a retry with the samepayment-identifieris never charged twice. - Free key, no form:
curl -X POST https://factline.dev/v1/key/trial -H "content-type: application/json" -d '{}'returns a starter key at once (100 credits, 14 days, no email), so the agent can go on alone. Add{"email":"you@company.com"}for a trial key with 2,000 credits a month, or later send the email toPOST /v1/key/emailwith the starter key to keep the same key. In MCP, theget_trial_keytool does both. - API key: send
x-api-key: fl_live_...(orAuthorization: Bearer fl_live_...) and calls use credits instead. Free trial key, a EUR 19 pack or monthly plans on /business. Building for many end users? Ask about the platform plan. - Free: address, neighbourhood, plate, car model and schools tools, and a free preview of every paid check.
Before your agent pays someone else
Pay guard, free. One line on any x402 client checks every payment before it is signed: the payTo wallet against OFAC, the seller's paying wallets, age and uptime, and the amount against its listed price and your budget. Deny aborts the payment.
import { withPayGuard } from "@factline/x402-pay-guard";
const client = withPayGuard(new x402Client().register("eip155:8453", new ExactEvmScheme(signer)), { maxUsd: 1 });
Or call GET /v1/pay/guard?url=...&pay_to=...&amount_usd=0.05, or the MCP tool x402_pay_guard. Answers cache for 10 minutes per seller and wallet.
Agents that buy from other x402 sellers can call the payee check first (x402_payee_check, USD 0.01): it reads the seller's 402, screens its wallets against OFAC, checks the domain and uptime and answers allow, review or deny. The free x402 Seller Health Index (x402_sellers) lists 500 Bazaar sellers with payers and daily probe results.
Receipts: every paid answer carries a receipt signed with Ed25519 (public key). Paying wallets can download a monthly statement from /v1/statement by signing in with the wallet (x402 sign-in-with-x).
Claude
claude.ai and Claude Desktop: Settings, Connectors, Add custom connector, then paste a server URL, for example https://factline.dev/mcp/chat.
Claude Code:
claude mcp add --transport http factline-kyc https://factline.dev/mcp/kyc # with an API key: claude mcp add --transport http factline-kyc https://factline.dev/mcp/kyc --header "x-api-key: fl_live_..."
Codex CLI
From the terminal:
codex mcp add factline-kyc --url https://factline.dev/mcp/kyc
Or in ~/.codex/config.toml (with an API key, read from an environment variable):
[mcp_servers.factline-kyc] url = "https://factline.dev/mcp/kyc" # with an API key: bearer_token_env_var = "FACTLINE_API_KEY"
ChatGPT
Settings, Apps and connectors, Advanced, turn on developer mode, then Create and paste https://factline.dev/mcp/gpt (free tools). The Factline plugin for the ChatGPT directory is in review.
Paid checks with your own key: paste https://factline.dev/mcp/gpt-supplier (supplier and invoice checks) or https://factline.dev/mcp/gpt-import (Chinese suppliers, forced-labour and trade lists) and choose OAuth. ChatGPT opens a Factline page where you paste your key once; checks then run on its credits. The same two URLs work in Claude and any MCP client that supports sign-in.
Le Chat (Mistral)
Intelligence, Connectors, Add connector, Custom MCP connector. Paste https://factline.dev/mcp/eu for European company and supplier checks, or https://factline.dev/mcp/gpt for Dutch address, vehicle, ECB rate and EU law facts. No sign-in needed. Le Chat shows the answers as text: the record cards need an app that supports MCP Apps.
Cursor, VS Code and GitHub Copilot, Gemini CLI
One click opens the editor and asks you to confirm. Free calls work without a key; ask the agent for a starter key when they run out.
Cursor by hand (~/.cursor/mcp.json):
{
"mcpServers": {
"factline-kyc": { "url": "https://factline.dev/mcp/kyc", "headers": { "x-api-key": "fl_live_..." } }
}
}
VS Code / Copilot (.vscode/mcp.json):
{
"servers": {
"factline-kyc": { "type": "http", "url": "https://factline.dev/mcp/kyc" }
}
}
Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"factline-kyc": { "httpUrl": "https://factline.dev/mcp/kyc" }
}
}
Microsoft Copilot Studio: in your agent, Tools, Add a tool, Model Context Protocol, then enter the server URL with no authentication (or an API key header).
Agent frameworks
OpenAI Agents SDK (Python):
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async with MCPServerStreamableHttp(params={"url": "https://factline.dev/mcp/kyc"}) as factline:
agent = Agent(name="Onboarding", instructions="Screen new customers.", mcp_servers=[factline])
result = await Runner.run(agent, "Is Acme Trading Ltd on a sanctions list?")
LangChain / LangGraph (pip install langchain-mcp-adapters):
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"factline": {"url": "https://factline.dev/mcp/kyc", "transport": "streamable_http"}})
tools = await client.get_tools()
Vercel AI SDK (TypeScript):
import { experimental_createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const mcp = await experimental_createMCPClient({
transport: new StreamableHTTPClientTransport(new URL("https://factline.dev/mcp/kyc")),
});
const tools = await mcp.tools();
DeepSeek, Cherry Studio and other OpenAI-compatible APIs (function calling, no MCP needed). Cherry Studio also takes the MCP URL https://factline.dev/mcp/kyc under Settings, MCP Servers, type Streamable HTTP. For plain tool calling, define the function, run the GET it returns and hand the JSON back as the tool result:
from openai import OpenAI
import requests, json
client = OpenAI(base_url="https://api.deepseek.com", api_key="sk-...")
tools = [{"type": "function", "function": {
"name": "sanctions_screen",
"description": "Screen a person or company name against EU, UN, UK and US sanctions lists. A match is a possible match, confirm before acting.",
"parameters": {"type": "object", "properties": {"name": {"type": "string"}}, "required": ["name"]}}}]
msgs = [{"role": "user", "content": "Is Acme Trading Ltd sanctioned?"}]
r = client.chat.completions.create(model="deepseek-chat", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
name = json.loads(call.function.arguments)["name"]
res = requests.get("https://factline.dev/v1/sanctions/screen", params={"name": name}, headers={"x-api-key": "fl_live_..."}).text
msgs += [r.choices[0].message, {"role": "tool", "tool_call_id": call.id, "content": res}]
print(client.chat.completions.create(model="deepseek-chat", messages=msgs, tools=tools).choices[0].message.content)
For a company check, point the same function at https://factline.dev/v1/kyb/check with name and country. Without a key the first 5 paid calls a day are free.
n8n: add an AI Agent node with an MCP Client Tool, endpoint https://factline.dev/mcp/kyc, transport HTTP Streamable. Or import the ready-made workflow Screen new signups with Factline KYC (Workflows, Import from file, then paste your key in the "Factline KYC check" node).
Python: pip install factline, then Factline(api_key=...).sanctions_screen(name="Acme"). PyPI
LangChain: pip install "factline[langchain]", then from factline.langchain import factline_tools. Vercel AI SDK: npm install @factline/ai-sdk, then tools: factlineTools({ apiKey }) (guide and tested example). Both give supplier invoice check, company check, Chinese supplier check, sanctions, pay guard and US company lookup as tools.
Plain HTTP
# free preview: checks the input and shows what the paid answer contains curl "https://factline.dev/v1/sanctions/screen/preview?name=Acme%20Trading" # paid call with an API key curl -H "x-api-key: fl_live_..." "https://factline.dev/v1/sanctions/screen?name=Acme%20Trading"
Without a key, the first 5 paid GET calls a day answer for free (header X-Factline-Free-Call), then 402 with an x402 payment request. Full list: docs, OpenAPI, llms.txt.
What answers look like
Every MCP result carries a one-line summary where the shape allows and a cite_as line, for example: Source: Factline (factline.dev), from RDW Open Data, retrieved 2026-10-11. Field names are stable. How screening works, list dates and data handling: trust page. Uptime: status.