{"name":"ILC Agent API","purpose":"Machine-readable starting points for agents seeking repeat-use, source-backed workflows.","recommended_workflows":[{"path":"/api/v1/workflows/location-pulse","frequency":"multiple times per day","price_usd":0.15,"why":"Current official weather and disaster context for a location."},{"path":"/api/v1/workflows/property-pulse","frequency":"daily or when property conditions change","price_usd":0.15,"why":"Municipal property records plus location risk context."},{"path":"/api/v1/workflows/provider-area-pulse","frequency":"on provider search or re-check","price_usd":0.15,"why":"NPPES provider identity plus CMS care-area context."},{"path":"/api/v1/context/workflows/budget-recovery","frequency":"when a person wants to recover after a missed budget plan","price_usd":0.15,"why":"Uses the current position and confirmed context, asks what changed, and does not persist the budget inputs."}],"payment":{"protocol":"x402","network":"Base mainnet","network_id":"eip155:8453","asset":"USDC","facilitator":"PayAI"},"standalone_tools":[{"name":"User-confirmed context","path":"/api/v1/context/read","status":"configuration_required","price_usd":0.05,"requires_tenant_api_key":true,"operations":["read","save","update","delete","erase","shared-learning opt-out"]}],"next_step":"POST one recommended workflow with its example body; if payment is required, follow the x402 challenge and retry.","agent_guide":"https://ilc-x402-api-1.onrender.com/agents","capabilities":"https://ilc-x402-api-1.onrender.com/capabilities","capability_map":[{"path":"/api/v1/municipal/query","method":"POST","use_when":"You need live Austin/Travis permit records or an Austin address zoning lookup.","example_request":{"county_or_zip":"78701","record_type":"permits"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"resources","source_types":["municipal_open_data","county_records"],"coverage":"Austin/Travis County coverage; unsupported counties are reported","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["Coverage is geography-specific.","Some deed and lien records remain linked for manual review."],"next_action":"Use property-due-diligence for a combined property brief."},{"path":"/api/v1/data/validate","method":"POST","use_when":"You need a quick integrity check on a JSON payload.","example_request":{"payload_to_check":{"id":123,"name":"example"}},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"verify","source_types":["payload_inspection"],"coverage":"Submitted JSON payload only","freshness":"computed_at_request","verification_status":"computed_check","limitations":["This validates structure and integrity; it does not verify external facts."],"next_action":"Use an authoritative lookup when external evidence is needed."},{"path":"/api/v1/finance/valuation","method":"POST","use_when":"You need a net settlement estimate for an asset value.","example_request":{"asset_id":"asset-123","target_value_usd":100},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"reason","source_types":["calculation"],"coverage":"Settlement estimate for supplied input","freshness":"computed_at_request","verification_status":"calculated","limitations":["This is an estimate, not a market valuation or financial advice."],"next_action":"Use a source-backed finance route for external financial facts."},{"path":"/api/v1/social/analyze","method":"POST","use_when":"You need social engagement, sentiment, bot-density, or trend signals.","example_request":{"handle_or_hashtag":"#example","platform":"all"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"metrics","source_types":["social_signals"],"coverage":"Supported platform signals vary","freshness":"retrieved_at_request","verification_status":"signal_based","limitations":["Signals may be estimated and are not official audience or revenue records."],"next_action":"Compare repeated calls before treating a trend as meaningful."},{"path":"/api/v1/gaming/metrics","method":"POST","use_when":"You need estimated gaming or on-chain metrics for a game or asset.","example_request":{"game_or_asset_id":"game-123","network":"onchain"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"metrics","source_types":["gaming_data","onchain_data"],"coverage":"Game or asset dependent","freshness":"retrieved_at_request","verification_status":"signal_based","limitations":["Estimated player, liquidity, and bot signals are not audited financial statements."],"next_action":"Use repeated snapshots to identify changes."},{"path":"/api/v1/health/verify","method":"POST","use_when":"You need a live CMS NPPES lookup for a valid NPI; this is not state licensure verification.","example_request":{"npi_or_code":"1679576722","query_type":"npi_lookup"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"entities","source_types":["government_registry"],"coverage":"CMS NPPES provider identity","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["NPPES does not prove licensure, credentialing, affiliation, or quality."],"next_action":"Use provider-area-pulse for local care context."},{"path":"/api/v1/weather/alerts","method":"POST","use_when":"You need current official National Weather Service alerts.","price":0.05,"example_request":{"location":"TX","limit":10},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"events","source_types":["government_alert_feed"],"coverage":"US NWS alert coverage","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["Absence of an alert is not proof that an area is safe."],"next_action":"Use location-pulse for weather plus FEMA context."},{"path":"/api/v1/finance/sec-company","method":"POST","use_when":"You need SEC filings and reported financial facts for a company.","price":0.05,"example_request":{"ticker_or_cik":"AAPL"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"entities","source_types":["government_filing"],"coverage":"SEC-reporting companies","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["Reported filing facts are not investment advice."],"next_action":"Use company-brief for SEC facts plus Treasury context."},{"path":"/api/v1/finance/treasury-debt","method":"POST","use_when":"You need current U.S. Treasury public-debt data.","price":0.05,"example_request":{"limit":1},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"metrics","source_types":["government_dataset"],"coverage":"US federal debt-to-penny dataset","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["This is a public macroeconomic dataset, not a forecast."],"next_action":"Use company-brief when macro context is needed alongside a company."},{"path":"/api/v1/public-safety/disasters","method":"POST","use_when":"You need official FEMA disaster declarations.","price":0.05,"example_request":{"state":"TX","limit":10},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"events","source_types":["government_dataset"],"coverage":"FEMA disaster declarations","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["Declarations do not cover every incident or establish current local conditions."],"next_action":"Use location-pulse to combine declarations with current weather alerts."},{"path":"/api/v1/food/drug-recalls","method":"POST","use_when":"You need FDA drug recall records.","price":0.05,"example_request":{"term":"acetaminophen","limit":10},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"events","source_types":["government_recall_feed"],"coverage":"FDA drug enforcement records matching the supplied term","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["No match does not prove that no issue exists outside the FDA dataset."],"next_action":"Verify the exact product and manufacturer against the returned source record."},{"path":"/api/v1/geo/resolve","method":"POST","use_when":"You need an official Census geocoder result.","price":0.05,"example_request":{"address":"1600 Pennsylvania Ave NW, Washington, DC"},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"search","source_types":["government_geocoder"],"coverage":"US Census address geocoding","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["A geocoder match is not proof of ownership, zoning, or occupancy."],"next_action":"Use the coordinates with a location or property workflow."},{"path":"/api/v1/health/hospital-quality","method":"POST","use_when":"You need CMS hospital comparison data.","price":0.05,"example_request":{"state":"TX","limit":10},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"resources","source_types":["government_dataset"],"coverage":"CMS hospital comparison records by state or ZIP","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["CMS comparison data is not a personal medical recommendation."],"next_action":"Use provider-area-pulse for provider identity plus area context."},{"path":"/api/v1/workflows/company-brief","method":"POST","use_when":"You need a two-source SEC plus Treasury company brief.","price":0.15,"example_request":{"ticker_or_cik":"AAPL"},"price_usd":0.15,"repeatable":true,"supports_snapshot_diff":false,"capability":"entities","source_types":["government_filing","government_dataset"],"coverage":"SEC company plus US Treasury context","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["This is a source-backed research brief, not investment advice."],"next_action":"Use sec-company or treasury-debt for narrower follow-up checks."},{"path":"/api/v1/workflows/property-due-diligence","method":"POST","use_when":"You need a multi-source property tax, permit, and zoning brief.","price":0.15,"example_request":{"county_or_zip":"78701","address":"1600 Congress Ave"},"price_usd":0.15,"repeatable":true,"supports_snapshot_diff":false,"capability":"resources","source_types":["municipal_open_data","county_records"],"coverage":"Austin/Travis County property coverage","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["This does not establish title, lien priority, zoning compliance, or safety."],"next_action":"Use property-pulse for repeat monitoring."},{"path":"/api/v1/workflows/location-pulse","method":"POST","use_when":"You need a repeatable current weather and disaster check for a location.","price":0.15,"example_request":{"address":"1600 Pennsylvania Ave NW, Washington, DC","limit":10},"price_usd":0.15,"repeatable":true,"supports_snapshot_diff":true,"capability":"status","source_types":["government_geocoder","government_alert_feed","government_dataset"],"coverage":"US address or state context","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["This is current-source context, not a safety guarantee or emergency dispatch determination."],"next_action":"Repeat with previous_snapshot and changes_only=true to detect changes."},{"path":"/api/v1/workflows/property-pulse","method":"POST","use_when":"You need repeatable property records plus location risk context.","price":0.15,"example_request":{"county_or_zip":"78701","address":"1600 Congress Ave","limit":10},"price_usd":0.15,"repeatable":true,"supports_snapshot_diff":true,"capability":"resources","source_types":["municipal_open_data","county_records","government_alert_feed","government_dataset"],"coverage":"Austin/Travis County property records plus US location context","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["Coverage remains county-specific and does not establish title, lien priority, zoning compliance, or safety."],"next_action":"Repeat with previous_snapshot and changes_only=true."},{"path":"/api/v1/workflows/provider-area-pulse","method":"POST","use_when":"You need repeatable provider identity and local CMS care context.","price":0.15,"example_request":{"npi":"1679576722","limit":10},"price_usd":0.15,"repeatable":true,"supports_snapshot_diff":true,"capability":"entities","source_types":["government_registry","government_dataset"],"coverage":"US NPPES provider identity plus CMS hospital area context","freshness":"retrieved_at_request","verification_status":"source_backed","limitations":["NPPES does not prove licensure or credentialing; hospital results do not prove affiliation."],"next_action":"Repeat with previous_snapshot and changes_only=true when re-checking a provider."},{"path":"/api/v1/verify","method":"POST","use_when":"You need to check whether an ILC evidence packet has complete provenance before relying on a claim.","price":0.05,"example_request":{"claim":"The location has no active alerts.","evidence":{"status":"success","sources":[]}},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"verify","source_types":["ilc_evidence_packet"],"coverage":"Evidence packets returned by ILC workflows","freshness":"computed_at_request","verification_status":"evidence_contract_check","limitations":["This checks provenance completeness; it does not independently prove the claim."],"next_action":"Use the original source URLs or a new authoritative workflow call for deeper verification."},{"path":"/api/v1/state/compare","method":"POST","use_when":"You need to compare two JSON-compatible states and identify changed paths.","price":0.05,"example_request":{"previous":{"alerts":[]},"current":{"alerts":[{"id":"example"}]}},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"state","source_types":["structured_state"],"coverage":"Two JSON-compatible states supplied in the request","freshness":"computed_at_request","verification_status":"deterministic_comparison","limitations":["A changed field is not necessarily an important change."],"next_action":"Use the changed paths to decide whether a workflow should be called again."},{"path":"/api/v1/feedback","method":"POST","use_when":"You need to record whether an ILC result was useful or corrected.","price":0.05,"example_request":{"workflow":"location-pulse","outcome":"used_for_monitoring","useful":true},"price_usd":0.05,"repeatable":false,"supports_snapshot_diff":false,"capability":"feedback","source_types":["agent_outcome"],"coverage":"Feedback explicitly submitted by the calling agent","freshness":"received_at_request","verification_status":"reported_outcome","limitations":["The first version records a safe receipt in application logs; it does not train a model or persist a customer profile."],"next_action":"Correlate feedback_id with application logs during evaluation."},{"path":"/api/v1/context/read","method":"POST","use_when":"You need the person's confirmed context to shape an AI response; the integrating app must also send its tenant bearer key.","price":0.05,"example_request":{"subject_id":"app-user-123"},"price_usd":0.05,"requires_tenant_api_key":true,"availability":"configuration_required","availability_detail":"Configure the dedicated context PostgreSQL database and context secrets; unavailable requests return 503 before x402 payment.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_confirmed_context"],"coverage":"Confirmed personal context for one tenant-scoped opaque subject","freshness":"confirmed_at_user","verification_status":"user_confirmed","limitations":["Requires the integrating application's tenant API key in addition to x402 payment.","Context may be incomplete; ask rather than infer."],"next_action":"Use only the confirmed items relevant to the current request."},{"path":"/api/v1/context/memories/save","method":"POST","use_when":"The person explicitly confirmed a personal preference, goal, constraint, life context, or support style to remember.","price":0.05,"example_request":{"subject_id":"app-user-123","category":"preference","content":"Prefers a weekly plan with room for unexpected costs.","confirmed_by_user":true},"price_usd":0.05,"requires_tenant_api_key":true,"availability":"configuration_required","availability_detail":"Configure the dedicated context PostgreSQL database and context secrets; unavailable requests return 503 before x402 payment.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_confirmed_context"],"coverage":"A confirmed personal context item","freshness":"confirmed_at_user","verification_status":"user_confirmed","limitations":["Only save after the person confirms the content.","Memory text is encrypted at rest."],"next_action":"Read the saved context only when it is relevant."},{"path":"/api/v1/context/memories/update","method":"POST","use_when":"The person confirmed a change to a saved context item.","price":0.05,"example_request":{"subject_id":"app-user-123","memory_id":"00000000-0000-0000-0000-000000000000","content":"Prefers a weekly plan with room for unexpected costs.","confirmed_by_user":true},"price_usd":0.05,"requires_tenant_api_key":true,"availability":"configuration_required","availability_detail":"Configure the dedicated context PostgreSQL database and context secrets; unavailable requests return 503 before x402 payment.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_confirmed_context"],"coverage":"An updated, user-confirmed personal context item","freshness":"confirmed_at_user","verification_status":"user_confirmed","limitations":["Requires renewed user confirmation.","Deletion controls are free."],"next_action":"Use the updated item as guidance, not as a complete account of the person."},{"path":"/api/v1/context/workflows/budget-recovery","method":"POST","use_when":"A person missed a budget plan and wants to replan from their current position without assuming why.","price":0.15,"example_request":{"subject_id":"app-user-123","period_budget":400,"spent_so_far":225,"days_remaining":7,"currency":"USD","plan_was_missed":true},"price_usd":0.15,"requires_tenant_api_key":true,"availability":"configuration_required","availability_detail":"Configure the dedicated context PostgreSQL database and context secrets; unavailable requests return 503 before x402 payment.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_supplied_budget_inputs","user_confirmed_context"],"coverage":"Current budget position and confirmed context for a rest-of-period recovery plan","freshness":"computed_at_request","verification_status":"calculated","limitations":["This is a planning aid, not financial advice.","Budget numbers and free-text explanations are not persisted."],"next_action":"Ask what changed after a missed plan, then help adjust the remaining plan without judgment."},{"path":"/api/v1/context/workflows/budget-recovery/preview","method":"POST","use_when":"Test the budget recovery calculation without stored context or database setup.","price":0,"example_request":{"period_budget":400,"spent_so_far":225,"days_remaining":7,"currency":"USD","plan_was_missed":true},"price_usd":0.0,"requires_tenant_api_key":false,"availability":"stateless_preview","availability_detail":"No database, tenant key, or persistent memory is used.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_supplied_budget_inputs"],"coverage":"Stateless recovery calculation","freshness":"computed_at_request","verification_status":"calculated","limitations":["No memory is read or written.","This is a planning aid, not financial advice."],"next_action":"Use the database-backed workflow when confirmed context is available."},{"path":"/api/v1/context/packet","method":"POST","use_when":"Prepare user-supplied context for a client-side AI assistant using device storage or the user's own PostgreSQL database.","price":0,"example_request":{"objective":"Plan a move","storage_mode":"user_postgres","constraints":["Keep costs predictable"],"context":[{"content":"Needs step-free access","source":"user-confirmed profile","user_confirmed":true}]},"price_usd":0.0,"requires_tenant_api_key":false,"availability":"stateless_preview","availability_detail":"No database, tenant key, or persistent memory is used.","repeatable":false,"supports_snapshot_diff":false,"capability":"context","source_types":["user_supplied_context"],"coverage":"Structured context packet for downstream client-side interpretation","freshness":"supplied_by_caller","verification_status":"not_independently_verified","limitations":["ILC does not infer, verify, load, or persist context on this route.","The calling assistant performs interpretation."],"next_action":"Review conflicts, gaps, uncertainty, and perspectives before responding."}],"limitations":["Source coverage and freshness vary by upstream provider.","A workflow response is evidence from listed sources, not a legal, medical, safety, or investment determination."]}