AIS Trail
Live AIS ship positions, vessel history, port calls and events, plus sanctions flags. Read-only.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http ais-trail 'https://api.aistrail.com/mcp' --header 'Authorization: <Optional. "Bearer <your AIS Trail API key>" for the archive tools (vessel_track, vessel_port_calls, port_calls, vessel_events, lookup_vessels). The live tools work without it.>'{
"mcpServers": {
"ais-trail": {
"type": "http",
"url": "https://api.aistrail.com/mcp",
"headers": {
"Authorization": "<Optional. \"Bearer <your AIS Trail API key>\" for the archive tools (vessel_track, vessel_port_calls, port_calls, vessel_events, lookup_vessels). The live tools work without it.>"
}
}
}
}التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
AIS Trail MCP server
Ship data for AI assistants: live AIS positions, vessel history, port calls, vessel events and sanctions flags. A hosted, read-only MCP server; there is nothing to install.
- Endpoint:
https://api.aistrail.com/mcp(Streamable HTTP) - Registry name:
com.aistrail/ais - Docs: https://aistrail.com/docs/mcp/
This repository holds the documentation for the hosted server. The server runs at AIS Trail.
Connect
The live tools work without a key. The archive tools need an AIS Trail API key, sent as Authorization: Bearer <key>. You can get one at https://aistrail.com (the Free plan includes one).
Claude Code:
claude mcp add --transport http aistrail https://api.aistrail.com/mcp \
--header "Authorization: Bearer $AIS_TRAIL_KEY"Clients that take a JSON config (VS Code, Cursor and others):
{
"servers": {
"aistrail": {
"type": "http",
"url": "https://api.aistrail.com/mcp",
"headers": { "Authorization": "Bearer YOUR_AIS_TRAIL_KEY" }
}
}
}Leave out headers to use only the live tools.
Tools
| Tool | What it answers | Key |
|---|---|---|
search_vessels | Find ships by name, MMSI or IMO number | No |
get_vessel | One ship now: identity, flag, size, position, speed, course, destination and ETA | No |
vessels_in_area | Ships heard in the last hour inside a box | No |
vessels_near | Ships heard in the last hour near a point or another ship | No |
find_port | Ports by name, UN/LOCODE or country | No |
data_status | Live ship count, archive coverage and data freshness | No |
vessel_track | Where a ship has been between two times | Yes |
vessel_port_calls | A ship's port calls with draught and cargo estimate | Yes |
port_calls | Arrivals and departures at one port | Yes |
vessel_events | Port arrivals and departures, stops, changes of name, IMO, destination or flag, AIS gaps and close encounters | Yes |
lookup_vessels | Records of up to 20 ships at once, with sanctions list flags (OFAC, UK, EU) | Yes |
Archive tools use the credits of your AIS Trail plan, the same way as the REST API. See the docs for the details.
Data
- Coverage: coverage map and data sources.
- REST API: https://aistrail.com/docs/
- Not for navigation.
Support
Open an issue in this repository or write to hello@aistrail.com.
الأسئلة الشائعة
ما هو AIS Trail؟
Live AIS ship positions, vessel history, port calls and events, plus sanctions flags. Read-only.
كيف أثبّت AIS Trail؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http ais-trail 'https://api.aistrail.com/mcp' --header 'Authorization: <Optional. "Bearer <your AIS Trail API key>" for the archive tools (vessel_track, vessel_port_calls, port_calls, vessel_events, lookup_vessels). The live tools work without it.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج AIS Trail إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل AIS Trail مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون AIS Trail؟
ينشره aistrail. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.