Developers

Build on AYBARION data in your systems and in Claude

A scoped REST API, an MCP server for AI assistants, recorded sanctions screening and signed webhooks. Every answer carries its source and licence, and the same data rules apply as on the platform.

Connect to Claude API reference Plans

Interfaces

Four ways to use AYBARION from your own software

All of them use an API key that an owner or admin of your company creates with MFA. A key carries only the scopes you choose, can expire after 1 to 365 days and can be revoked at any time.

Model Context Protocol

Connect AYBARION to Claude

The AYBARION MCP server gives Claude the AYBİ data tools: products and HS codes in eight languages, companies for a product and country, the company directory and company cards from official open registers, official trade statistics, buyer markets, export opportunities, import requirements and duty rates, verified exporters and a guide to the AYBARION pages.

Choose a Professional plan or higher. An owner or admin creates an API key with the aybi:tools scope on Integrations. The key is shown once.
Add AYBARION as a remote MCP server in your Claude client. Server URL https://aybarion.com/mcp, transport Streamable HTTP, request header Authorization: Bearer ayb_live_…
Ask Claude a trade question in your language. Claude calls the tools it needs and names the source of every figure.

Custom connectors in the Claude apps sign in with OAuth, which AYBARION does not offer yet. Claude Code, the Claude API and other MCP clients that send the key as a request header work today.

Scopes

What a key can do

Every scope needs a plan with the Developer API and an active subscription or trial. Each key has a per minute rate limit, and API calls per day are a company wide allowance of your plan.

Webhooks

Events pushed to your endpoint

Webhooks are HTTPS only and signed with HMAC SHA256 and a timestamp. Failed deliveries are retried for about 19 hours. Sanctions list updates arrive as counts of added, removed and renamed entries, never as names.

Data rules

The same rules as on the platform

No contact data: AYBARION never returns e-mails, phone numbers, names of people or their addresses, in the API, the MCP tools or AI answers.
No company data for Russia, Belarus, Iran, North Korea, Syria, Cuba, Peru or the Philippines. Trade statistics stay available.
Sanctions screening returns potential matches for human review, never a legal determination. Listed individuals are never named.
Data comes from official and openly licensed sources. Each response names the publisher, the licence and the record ids.