MCP Server
OpenWeather for agents
org.openweathermap/agents
What this MCP does
Discovers and fetches catalogued OpenWeather data products, while supporting account management, usage checks, and hosted top-ups.
Capabilities
Tools
6
tools
account_status
Account status
Reads the account behind the secret: tier, accepted Terms version, the products it may call, the balance in credits the account bought minus the spend those credits funded, the last 30 days of usage per day, product and key, and the 50 latest balance movements. A product's own daily credits are spent before that balance and are no part of it, so a call can be served while it reads zero; list_products carries each product's credit account. Pass the secret sign_up returned as the secret argument; the data key your client configuration sends cannot read the account and answers 403 wrong_credential. Charges nothing; without a string the platform answers 401 invalid_key.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'secret': {'type': 'string', 'minLength': 1, 'description': "the account's secret — the string sign_up returned as secret; the client configuration's header holds the data key, which this tool cannot use; when both are present the argument wins"}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
fetch_data
Fetch data
Fetches one data response: GET data.openweathermap.org/{product}/{route} with the query parameters you pass, using the data key from your client configuration's Authorization header or the data_key argument — never the secret, which fetches nothing. A successful call is billed the product's price per call; a refused call costs nothing. The result carries the payload with the platform's meta block (licence and attribution) and the rate-limit headers; the balance is read with account_status, never from a data response. Every refusal is the platform's error envelope unchanged — a code from https://agents.openweathermap.org/errors.json; 402 payment_required means the key is known but cannot pay for this product now, and 401 invalid_key means it is authorized for no product at all, most often because every credit is spent. Both carry an action_url: a human tops up there (get_topup_link returns the page) and the same key serves again within the engine's build interval plus the region's poll interval.
Read only
Open world
Input schema
{'type': 'object', 'required': ['product', 'route'], 'properties': {'route': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]+(/[A-Za-z0-9_-]+)*$', 'maxLength': 128, 'description': 'a route from get_product, without the product prefix — e.g. current or timeline/1h'}, 'params': {'type': 'object', 'description': 'query parameters, sent as given; the parameters a route requires are in get_product', 'additionalProperties': {'type': ['string', 'number', 'integer', 'boolean']}}, 'product': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,63}$', 'description': 'a product slug from list_products'}, 'data_key': {'type': 'string', 'minLength': 1, 'description': 'only when the client cannot send an Authorization header — the data_key.key sign_up returned in this session; when both are present the argument wins'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
get_product
Get product
Returns one product by slug: its live catalogue entry (price, licence, lifecycle state, the specification address) together with the routes fetch_data can call and the parameters each route requires, taken from the platform's published product record. Needs no key and charges nothing. Use it before fetch_data — the route names come from here; an unknown slug answers with the slugs the catalogue serves.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['product'], 'properties': {'product': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_-]{0,63}$', 'description': 'a product slug from list_products'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
get_topup_link
Get top-up link
Opens a top-up for the account and returns the payment intent with hosted_url, the payment provider's short-lived page where a human completes the payment — no tool pays, and card details never touch the Forum. amount_minor is in cents; the platform accepts USD only and a minimum of 1000 (= $10). Pass the secret sign_up returned as the secret argument; the data key cannot open a payment. Asking again while a page is open returns the same page. Bought credits appear in account_status once the payment completes.
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['amount_minor'], 'properties': {'secret': {'type': 'string', 'minLength': 1, 'description': "the account's secret — the string sign_up returned as secret; the data key in the client configuration cannot open a payment; when both are present the argument wins"}, 'currency': {'type': 'string', 'default': 'USD', 'description': 'USD is the only currency the platform accepts; the platform refuses any other'}, 'amount_minor': {'type': 'integer', 'minimum': 1, 'description': "the amount in the currency's minor unit (cents); the platform's minimum is 1000 = $10 and the platform checks it"}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
list_products
List products
Lists every data product the Forum serves, as the platform's own catalogue answer: slug, title, lifecycle state, price in credits per call (1 credit = $0.001; the quoted price is the charged price), licence and attribution text, and the address of the product's route specification. Needs no key and charges nothing. Call get_product next for a product's routes and required parameters.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
sign_up
Sign up
Creates a Forum account for an email address under the Terms version currently served, and returns the account, its secret — the one string that runs the account, shown exactly once — and its first data key, shown exactly once. It grants the account no credits of its own: a new account's free calls are the daily credit account of each product that gives one, spendable on that product alone and replaced every night, and list_products states which products give one and how much. The result's configure block is the client configuration entry that sends the data key from then on; until the client reconnects, pass data_key.key as data_key on fetch_data. Keep the secret with the owner and pass it as secret on account_status and get_topup_link. An address that already has an account answers 409 email_exists with next_action login_to_link.
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'format': 'email', 'maxLength': 254, 'description': "the owner's email address — the account's identity; one account per address"}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id'], 'properties': {'body': {}, 'fault': {'type': 'object'}, 'usage': {'type': 'object'}, 'record': {'type': 'object'}, 'status': {'type': ['integer', 'null']}, 'account': {}, 'headers': {'type': 'object'}, 'upstream': {'type': ['string', 'null']}, 'body_text': {'type': 'string'}, 'configure': {'type': 'object'}, 'transport': {'type': 'object'}, 'key_source': {'enum': ['header', 'argument', 'none'], 'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': True}
History
Recent tool changes
Added
fetch_data
Sept. 17, 2026, 12:54 p.m.
Added
get_topup_link
Sept. 17, 2026, 12:54 p.m.
Added
account_status
Sept. 17, 2026, 12:54 p.m.
Added
sign_up
Sept. 17, 2026, 12:54 p.m.
Added
get_product
Sept. 17, 2026, 12:54 p.m.
Added
list_products
Sept. 17, 2026, 12:54 p.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
SharksAPI.AI
ai.sharksapi/marketing
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…