Connect any AI agent to your data streams.
@useconduit/mcp
MCP server for Conduit โ connect any AI agent to your data streams.
๐ API Docs ยท ๐ Website ยท ๐ฆ npm ยท ๐ป GitHub
Quick Start
Get an API key from platform.usecondu.it/tokens, then add to your AI editor config:
Claude Code / Claude Desktop
Add to ~/.claude/settings.json:
{
"mcpServers": {
"conduit": {
"command": "npx",
"args": ["-y", "@useconduit/mcp"],
"env": {
"CONDUIT_API_KEY": "conduit_sk_..."
}
}
}
}
Cursor
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"conduit": {
"command": "npx",
"args": ["-y", "@useconduit/mcp"],
"env": {
"CONDUIT_API_KEY": "conduit_sk_..."
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"conduit": {
"command": "npx",
"args": ["-y", "@useconduit/mcp"],
"env": {
"CONDUIT_API_KEY": "conduit_sk_..."
}
}
}
}
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
CONDUIT_API_KEY |
โ | โ | Your Conduit API key |
CONDUIT_API_URL |
โ | https://api.usecondu.it |
Custom API endpoint |
Tools
| Tool | Description |
|---|---|
conduit_list_streams |
List all data streams |
conduit_get_schema |
Get schema for a stream (columns, types, codecs) |
conduit_create_stream |
Create a new stream |
conduit_ingest |
Send events to a stream |
conduit_list_events |
Query events with pagination & time range filters |
conduit_add_forward |
Add a forwarding destination (HTTP, MQTT, or WebSocket) with auth options |
conduit_stream_stats |
Get ingestion statistics (event count, rate, latency) |
conduit_analyze_schema |
Analyze a JSON payload for optimal schema |
conduit_feedback |
Submit feedback to the Conduit team |
conduit_backfill |
Replay historical events to forwarding destinations |
conduit_backfill_status |
Check backfill job progress or list all jobs |
conduit_time_range |
Get earliest/latest event timestamps for a stream |
Resources
| URI | Description |
|---|---|
conduit://streams |
All streams |
conduit://streams/{name} |
Stream details + schema |
conduit://stats |
Platform-wide statistics |
API Documentation
Full interactive API docs are available at api.usecondu.it/docs (powered by Scalar).
Key endpoints:
| Method | Endpoint | Description |
|---|---|---|
POST |
/v1/{tenant}/{stream} |
Ingest events (any protocol: HTTP, WebSocket, MQTT) |
GET |
/api/v1/streams |
List streams |
GET |
/api/v1/streams/{name} |
Stream details + schema |
GET |
/api/v1/streams/{name}/events?from=&to=&limit= |
Query events with time range |
GET |
/api/v1/streams/{name}/stats |
Ingestion statistics |
GET |
/api/v1/streams/{name}/schema-history |
Schema evolution history |
POST |
/api/v1/streams/{name}/forwards |
Add forwarding destination |
POST |
/api/v1/streams/{name}/backfill |
Start backfill job |
GET |
/api/v1/streams/{name}/backfill |
List backfill jobs |
GET |
/api/v1/streams/{name}/time-range |
Event time range |
POST |
/api/v1/tokens |
Create API token |
GET |
/api/v1/account |
Account info + usage |
Machine-readable API specs:
- OpenAPI 3.1: api.usecondu.it/openapi.json
- LLM-friendly: api.usecondu.it/llms.txt
- LLM full spec: api.usecondu.it/llms-full.txt
What is Conduit?
Conduit is the lightweight data layer between your services. Send any JSON โ schemas aren't defined, they emerge. And they evolve as your sources do.
- One endpoint, any protocol โ HTTP, WebSocket, MQTT/S on the same path
- AI-powered schema detection โ zero configuration, runs locally (your data never leaves)
- Real-time forwarding โ HTTP webhooks, MQTT brokers, WebSocket endpoints with full auth options
- Backfill โ replay historical events to new destinations
- Built for agents โ MCP-native from day one, feedback loop included
- European infrastructure ๐ช๐บ โ all data hosted and processed in the EU, GDPR-compliant by design
How agents use Conduit
Agent: "I see live sensor data flowing in. I'll pipe it to our datawarehouse and add hot storage."
โธ conduit_list_events(stream: "sensors", limit: 1000)
โณ 1,000 events ยท 18.4 MB raw โ 1.1 MB stored (94% compressed)
โธ conduit_add_forward(stream: "sensors", type: "http", url: "https://dwh.acme.io/ingest")
โณ Destination added ยท forwarding to datawarehouse
โธ conduit_add_forward(stream: "sensors", type: "mqtt", broker: "mqtt://redi
Tools (12)
conduit_list_streamsList all data streamsconduit_get_schemaGet schema for a stream (columns, types, codecs)conduit_create_streamCreate a new streamconduit_ingestSend events to a streamconduit_list_eventsQuery events with pagination & time range filtersconduit_add_forwardAdd a forwarding destination (HTTP, MQTT, or WebSocket) with auth optionsconduit_stream_statsGet ingestion statistics (event count, rate, latency)conduit_analyze_schemaAnalyze a JSON payload for optimal schemaconduit_feedbackSubmit feedback to the Conduit teamconduit_backfillReplay historical events to forwarding destinationsconduit_backfill_statusCheck backfill job progress or list all jobsconduit_time_rangeGet earliest/latest event timestamps for a streamEnvironment Variables
CONDUIT_API_KEYrequiredYour Conduit API keyCONDUIT_API_URLCustom API endpointConfiguration
{"mcpServers": {"conduit": {"command": "npx", "args": ["-y", "@useconduit/mcp"], "env": {"CONDUIT_API_KEY": "conduit_sk_..."}}}}