query_catalog
Pack: vizier · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/query_catalog for the schema, then POST the same URL with its arguments for the data.
VizieR astronomical catalogue service at CDS Strasbourg, return data rows from one published catalogue, identified by its VizieR id such as “I/345/gaia2” (Gaia DR2). Takes optional column selection and a numeric constraint expression, up to 50000 rows. Answers what a published astronomy catalogue records for stars, galaxies or other objects meeting a cut.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
catalog | string | yes | |
constraint | string | no | Solr-style constraints, e.g. “Plx>20” |
columns | string | no | Comma-sep columns to return. |
max | number | no | 1-50000 (default 50). |
Example call
Arguments
{
"catalog": "I/345/gaia2"
}
curl
curl -X POST https://gateway.pipeworx.io/vizier/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"query_catalog","arguments":{"catalog":"I/345/gaia2"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('query_catalog', {
"catalog": "I/345/gaia2"
});
More examples
{
"catalog": "J/ApJ/896/72/table1",
"constraint": "Plx>20",
"columns": "RAJ2000,DEJ2000,Plx",
"max": 1000
}
Response shape
Full JSON Schema
{
"type": "object",
"description": "Single catalogue query results",
"oneOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"raw"
],
"description": "Format indicator when JSON parsing fails"
},
"body": {
"type": "string",
"description": "Raw text response (first 4000 chars)"
}
},
"required": [
"format",
"body"
]
}
]
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the vizier pack
{
"mcpServers": {
"vizier": {
"url": "https://gateway.pipeworx.io/vizier/mcp"
}
}
}
See Getting Started for client-specific install steps.