ingest_url_data_source
Create a new data source by fetching a public URL on the server side. Handles CSV, TSV, JSON, Excel, TXT, and PDF. Private networks (RFC 1918, loopback, cloud metadata) are blocked. Returns the data_source_id once preprocessing has started. Use this for files larger than the 25 MB inline upload cap.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"url": "<url>"
},
"name": "ingest_url_data_source"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public http(s) URL of the file to ingest. The server fetches it once at call time; the URL is not re-fetched on subsequent analyses. Private networks (RFC 1918, loopback, link-local, cloud metadata) are blocked. | |
| name | Yes | Display name for the new data source. | |
| format | No | Optional format hint. If omitted, the server infers it from the Content-Type header and URL extension. | |
| description | No | Optional human note stored on the data source. | |
| wait_seconds | No | Seconds to block waiting for preprocessing before returning. 0 returns immediately. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| format | Yes | Detected file format (csv, json, xlsx, ...). | |
| status | Yes | Preprocessing status. Poll get_data_source_schema until "active". | |
| web_url | No | ||
| raw_data_id | Yes | ||
| bytes_fetched | Yes | ||
| data_source_id | Yes |