aoi
Environmental intelligence for AI agents via MCP.
Should I use this
Quality & Safety
Findings (15)
- HIGH
- MEDIUMin execute_quote
- LOWin quote_energy_infrastructure_risk
- LOWin quote_insurance_underwriting_risk
- LOWin quote_regulatory_compliance_risk
- LOWin quote_infrastructure_resilience_score
- LOWin quote_supply_chain_climate_risk
- LOWin quote_industrial_emission_detection
- LOWin quote_glacier_retreat_monitoring
- LOWin quote_climate_scenario_simulation
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"aoi": {
"url": "https://carbonaa.org/functions/aoiMcpServer"
}
}
}Remote endpoints
https://carbonaa.org/functions/aoiMcpServerstreamable-httpWhat it can do
Tool inventory
Tools (46)
🟢discover_capabilities(domain)
List all available environmental intelligence capabilities. Returns capability IDs, names, descriptions, and domains. Use this first to see what AOI can do. Each capability requires a quote before execution. No API key required.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Optional filter by scientific domain (climate_risk, carbon_assessment, water_stress, heat_risk, land_change, asset_climate_risk, etc.)"
}
}
}🟢get_capability_details(capability_id)
Get full details for a specific capability including required inputs, expected outputs, confidence level, and domain. No API key required. Returns CAPABILITY_NOT_FOUND if the id does not exist.
Input Schema
{
"type": "object",
"properties": {
"capability_id": {
"type": "string",
"description": "The capability ID (e.g. climate_risk_assessment, carbon_assessment)"
}
},
"required": [
"capability_id"
]
}⚪request_quote(capability_id, input_data, idempotency_key)
Request a FREE commercial quote for a capability execution. AOI dynamically evaluates the price based on the requested service. Returns quote_id, final USD price, currency, and validity (15 min). No execution happens and NO credits are consumed — review the price first, then call execute_quote. Requires an API key (X-API-Key header or Authorization: Bearer <key>).
Input Schema
{
"type": "object",
"properties": {
"capability_id": {
"type": "string",
"description": "The capability ID to quote"
},
"input_data": {
"type": "object",
"description": "Capability-specific input parameters (e.g. {lat, lon})",
"additionalProperties": true
},
"idempotency_key": {
"type": "string",
"description": "Optional idempotency key. Same key + same request returns the same quote."
}
},
"required": [
"capability_id",
"input_data"
]
}⚪execute_quote(quote_id, input_data, execution_idempotency_key)
Execute a capability using an accepted quote. The quote must belong to the agent, be unexpired, and the input_data must match the quoted request. The quoted USD price is deducted from your prepaid balance on success and released on failure. Returns structured intelligence with provenance. If balance is insufficient, returns INSUFFICIENT_CREDIT (top up at https://carbonaa.org/aoi/console). Requires an API key. THIS IS THE ONLY OPERATION THAT CONSUMES PREPAID CREDITS.
Input Schema
{
"type": "object",
"properties": {
"quote_id": {
"type": "string",
"description": "The quote_id returned by request_quote"
},
"input_data": {
"type": "object",
"description": "The same input_data that was quoted",
"additionalProperties": true
},
"execution_idempotency_key": {
"type": "string",
"description": "Optional idempotency key for execution. Same key returns the same result without duplicate execution."
}
},
"required": [
"quote_id",
"input_data"
]
}🟢get_pricing_model
Get the AOI commercial model description. AOI uses a quote-first dynamic pricing model — agents request quotes and receive a final commercial price before execution. Quotes are free; execution requires prepaid balance. No API key required.
Input Schema
{
"type": "object",
"properties": {}
}🟢get_trust_governance
Get AOI trust and governance framework including security model, data classification, audit trail, and zero-trust policy. No API key required.
Input Schema
{
"type": "object",
"properties": {}
}🟢get_runtime_status
Get current platform runtime status including active capabilities count and service health. No API key required.
Input Schema
{
"type": "object",
"properties": {}
}🟢get_settlement(transaction_id)
Get settlement details for a transaction, including captured amount, settled amount, refunded amount, and settlement status. Requires an API key.
Input Schema
{
"type": "object",
"properties": {
"transaction_id": {
"type": "string",
"description": "The transaction to look up settlement for"
}
},
"required": [
"transaction_id"
]
}⚪quote_energy_infrastructure_risk
Request a FREE commercial quote for: Energy Infrastructure Climate Risk. Climate risk assessment for energy infrastructure assets Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_insurance_underwriting_risk
Request a FREE commercial quote for: Insurance Underwriting Climate Risk. Climate risk scoring for insurance underwriting decisions Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_regulatory_compliance_risk
Request a FREE commercial quote for: Regulatory Compliance Risk Assessment. Assess regulatory compliance risk for environmental regulations Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_crop_yield_forecast
Request a FREE commercial quote for: Crop Yield Forecast. Satellite-derived crop yield forecast for agricultural regions Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_infrastructure_resilience_score
Request a FREE commercial quote for: Infrastructure Resilience Score. Infrastructure climate resilience scoring for critical assets Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_supply_chain_climate_risk
Request a FREE commercial quote for: Supply Chain Climate Risk. Climate risk assessment across a supply chain network Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_water_scarcity_forecast
Request a FREE commercial quote for: Water Scarcity Forecast. 12-month water scarcity forecast using climate models Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_urban_heat_island
Request a FREE commercial quote for: Urban Heat Island Assessment. Urban heat island effect intensity and exposure mapping Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_deforestation_risk_score
Request a FREE commercial quote for: Deforestation Risk Score. Rapid deforestation risk score for a region Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_methane_leak_detection
Request a FREE commercial quote for: Methane Leak Detection. Satellite-based methane leak detection for oil & gas facilities Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_industrial_emission_detection
Request a FREE commercial quote for: Industrial Emission Detection. Detect unauthorized industrial emissions using thermal satellite data Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}🟡quote_glacier_retreat_monitoring
Request a FREE commercial quote for: Glacier Retreat Monitoring. Continuous glacier retreat monitoring using satellite change detection Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_permafrost_thaw_risk
Request a FREE commercial quote for: Permafrost Thaw Risk. Permafrost thaw risk evaluation for Arctic infrastructure Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_coastal_erosion_risk
Request a FREE commercial quote for: Coastal Erosion Risk Assessment. Coastal erosion vulnerability using satellite imagery Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_air_quality_assessment
Request a FREE commercial quote for: Air Quality Assessment. Air quality index and pollutant analysis for urban areas Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_seismic_risk_score
Request a FREE commercial quote for: Seismic Risk Score. Seismic activity risk score for a location Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_vegetation_health_index
Request a FREE commercial quote for: Vegetation Health Index. NDVI-based vegetation health and stress index Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_soil_moisture_risk
Request a FREE commercial quote for: Soil Moisture Risk Assessment. Soil moisture drought and agricultural risk evaluation Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_custom_scientific_report
Request a FREE commercial quote for: Custom Scientific Report. Bespoke scientific research report for specific client requirements Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_climate_scenario_simulation
Request a FREE commercial quote for: Climate Scenario Simulation. Multi-scenario climate simulation with cascading impact analysis Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_confidence_assessment
Request a FREE commercial quote for: Confidence Assessment Report. Assess and report confidence levels for scientific conclusions Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_scientific_evidence_package
Request a FREE commercial quote for: Scientific Evidence Package. Generate a complete, explainable scientific evidence package Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}🟡quote_satellite_change_detection
Request a FREE commercial quote for: Satellite Change Detection. Continuous satellite-based change detection for monitored areas Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_digital_twin_evaluation
Request a FREE commercial quote for: Digital Twin Evaluation. Evaluate and score a digital twin model for accuracy and completeness Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_esg_intelligence
Request a FREE commercial quote for: ESG Intelligence Report. ESG intelligence synthesis for investment decisions Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_asset_climate_risk
Request a FREE commercial quote for: Asset Climate Risk Scoring. Climate risk scoring for specific physical assets Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_environmental_due_diligence
Request a FREE commercial quote for: Environmental Due Diligence. Comprehensive environmental due diligence for mergers, acquisitions, and investments Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_climate_forecast_interpretation
Request a FREE commercial quote for: Climate Forecast Interpretation. Interpret climate model forecasts into actionable intelligence Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_water_stress_analysis
Request a FREE commercial quote for: Water Stress Analysis. Water stress and scarcity analysis for regions Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_biodiversity_assessment
Request a FREE commercial quote for: Biodiversity Assessment. Biodiversity evaluation using multi-source ecological data Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_carbon_assessment
Request a FREE commercial quote for: Carbon Assessment. Carbon footprint and emissions assessment Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}🟡quote_land_change_detection
Request a FREE commercial quote for: Land Change Detection. Detect changes in land use between time periods Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_land_cover_classification
Request a FREE commercial quote for: Land Cover Classification. Satellite-based land cover classification Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_drought_assessment
Request a FREE commercial quote for: Drought Assessment. Drought severity and duration assessment Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_wildfire_exposure
Request a FREE commercial quote for: Wildfire Exposure Assessment. Wildfire exposure evaluation using satellite thermal and vegetation data Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_heat_risk_score
Request a FREE commercial quote for: Heat Risk Score. Heat vulnerability analysis for urban areas Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_flood_risk_score
Request a FREE commercial quote for: Flood Risk Score. Rapid flood risk score for a specific location Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}⚪quote_climate_risk_assessment
Request a FREE commercial quote for: Climate Risk Assessment. Comprehensive climate risk evaluation for a geographic area or asset Returns a binding USD price and quote_id (valid 15 min); no execution yet and no credits consumed. Use execute_quote with the quote_id to run it — execution consumes prepaid credits. Requires an API key (X-API-Key or Authorization: Bearer).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": true
}Community
Evidence