search_factors
Pack: climatiq · Endpoint: https://gateway.pipeworx.io/climatiq/mcp
Search Climatiq’s emission-factor database. Use to discover factor IDs and required parameters before calling estimate_emissions. Filter by query, category, source (e.g., “EPA”, “DEFRA”), region (ISO code), or year.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Free-text search (e.g., “electricity grid”, “concrete production”) |
category | string | no | Climatiq category (e.g., “electricity”, “fuel”, “freight”, “computing”) |
source | string | no | Source dataset (e.g., “EPA”, “DEFRA”, “BEIS”, “ecoinvent”) |
region | string | no | ISO-3166 region code (e.g., “US”, “GB”, “DE”) |
year | number | no | Publication year |
unit_type | string | no | Activity unit type (Energy, Volume, Distance, Mass, etc.) |
results_per_page | number | no | 1-100 (default 25) |
page | number | no | 1-based page (default 1) |
Example call
curl -X POST https://gateway.pipeworx.io/climatiq/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_factors","arguments":{}}}'Response shape
Always returns: page, total_pages, total_results, returned, results
| Field | Type | Description |
|---|---|---|
page | number | null | Current page number |
total_pages | number | null | Total number of pages available |
total_results | number | null | Total number of matching results |
returned | number | Number of results returned in this response |
results | array | Array of emission factor records |
Full JSON Schema
{
"type": "object",
"properties": {
"page": {
"type": [
"number",
"null"
],
"description": "Current page number"
},
"total_pages": {
"type": [
"number",
"null"
],
"description": "Total number of pages available"
},
"total_results": {
"type": [
"number",
"null"
],
"description": "Total number of matching results"
},
"returned": {
"type": "number",
"description": "Number of results returned in this response"
},
"results": {
"type": "array",
"description": "Array of emission factor records",
"items": {
"type": "object",
"properties": {
"activity_id": {
"type": [
"string",
"null"
],
"description": "Climatiq activity identifier"
},
"id": {
"type": [
"string",
"null"
],
"description": "Factor ID"
},
"name": {
"type": [
"string",
"null"
],
"description": "Factor name"
},
"category": {
"type": [
"string",
"null"
],
"description": "Factor category"
},
"sector": {
"type": [
"string",
"null"
],
"description": "Industry sector"
},
"source": {
"type": [
"string",
"null"
],
"description": "Data source (e.g., EPA, DEFRA)"
},
"year": {
"type": [
"number",
"null"
],
"description": "Publication year"
},
"region": {
"type": [
"string",
"null"
],
"description": "ISO region code"
},
"region_name": {
"type": [
"string",
"null"
],
"description": "Human-readable region name"
},
"unit_type": {
"type": [
"string",
"null"
],
"description": "Activity unit type (Energy, Volume, etc.)"
},
"lca_activity": {
"type": [
"string",
"null"
],
"description": "LCA activity reference"
},
"access_type": {
"type": [
"string",
"null"
],
"description": "Access level of the factor"
}
}
}
}
},
"required": [
"page",
"total_pages",
"total_results",
"returned",
"results"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"climatiq": {
"url": "https://gateway.pipeworx.io/climatiq/mcp"
}
}
}See Getting Started for client-specific install steps.