czechfabric-sdk 0.2.3

Python SDK for Czech Intelligence Fabric (CzechFabric MCP)

🇨🇿 CzechFabric SDK

The official Python SDK for accessing the Czech Intelligence Fabric (MCP) - a unified API for Czech public services including transport, geolocation, and contextual AI tooling.

---

🚀 Features

• ✅ Plan public transport trips using OpenTripPlanner
• 🚏 Real-time departures from stop names or coordinates
• 🗺️ Geocode / Reverse-geocode locations
• 📍 Find nearby stops
• 📦 Fetch stop metadata and zone info
• 🧠 List available tools and generate LLM-friendly summaries
• 🔁 Built-in retry, caching, and error handling

---

📦 Installation

pip install czechfabric-sdk

---

⚡ Quick Start

from czechfabric_sdk.client import CzechFabricClient

client = CzechFabricClient(
    api_key="your-api-key",
    base_url="https://mcp.czechfabric.cz"
)

# Example: Plan a trip
trip = await client.plan_trip("Florenc", "Karlovo náměstí", departure_time="in 15 minutes")
print(trip)

---

📚 Usage Examples

Explore detailed examples in examples.md:

• 🚉 Plan a trip
• 📆 Get departures
• 🧭 Geocode / Reverse geocode
• 📍 Nearby stops
• 🧾 Stop metadata
• 📋 List stops
• 🛠️ List available tools
• 🤖 Generate prompt summary

---

🧰 Tool Management

You can dynamically list tools exposed by the MCP server:

tools = await client.get_tool_names()
prompt = await client.get_tool_prompt_summary()
print(prompt)

This is helpful for LLM-based assistants or debugging available capabilities.

---

🔐 Authentication

All requests require an API key:

client = CzechFabricClient(api_key="your-api-key", base_url="https://mcp.czechfabric.cz")

You can generate your key from your CzechFabric user dashboard.

---

⚠️ Error Handling

The SDK provides structured exceptions:

• NetworkError – server unreachable or timed out
• InvalidAPIKeyError – auth failure
• RateLimitExceededError – too many requests
• ToolExecutionError – tool execution failed

---

🧪 Running Tests

pip install -r requirements-dev.txt
pytest tests/

---

📎 License

MIT © 2025 Aliyu Abdulbasit Ayinde

---

🌐 Project Links

• 🧠 MCP Server: https://mcp.czechfabric.cz
• 💬 Feedback & Issues: GitHub Issues