Use Swellmeter Trending MCP with OpenAI Codex CLI
Google trending searches API + MCP: 30 countries, day lists, 30-day history. $5 pack; 50 free/day.
Remote MCP server (Streamable HTTP), nothing to install. Free: 50 free calls/day · Paid: $5 pack; $19/mo
Set it up
- Open ~/.codex/config.toml (create it if needed).
- Add the [mcp_servers] table shown and save.
- Start Codex; the server's tools are available to the agent.
- Ask a question the tools can answer.
Add to ~/.codex/config.toml:
[mcp_servers.swellmeter-api]
url = "https://swellmeter-api.cybermaxtools.com/mcp?via=use-with-codex"With a paid key:
[mcp_servers.swellmeter-api]
url = "https://swellmeter-api.cybermaxtools.com/mcp?via=use-with-codex"
env_http_headers = { "x-api-key" = "CYBERMAX_API_KEY" }env_http_headers maps the header to an environment variable name, so the key stays in your environment.
- ~/.codex/config.toml (or .codex/config.toml in a trusted project)
Tools you get
Endpoint checked 2026-10-09: https://swellmeter-api.cybermaxtools.com/mcp answered an MCP initialize (protocol 2025-06-18) and tools/list with 5 tools, all marked read-only. No key was used and no tool was called.
| Tool | What it does | Required inputs |
|---|---|---|
trending_now | Newest Google trending searches for 1-5 countries (ISO-2 codes): query, approximate traffic, start time, first seen today, other countries where it trends, news links. | geo |
trending_day | Every trending search seen on one UTC day (today or the last 30 days) for 1-5 countries, biggest first, with first/last seen, peak traffic and news. | geo |
cross_country_trends | Topics trending right now in 2+ of the 30 countries, most countries first. | none |
topic_history | Search the last 30 days of trending searches for a topic; returns each matching search with the countries, first seen, last day seen and peak traffic. | q |
countries | The 30 country codes, names and last read time. | none |
Test the endpoint from a terminal
This lists the tools without a key and without calling any of them:
curl -s https://swellmeter-api.cybermaxtools.com/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'If it does not work
- Each server is its own [mcp_servers.<name>] table; keep the name to letters, digits, dashes and underscores.
- For a fixed header value instead of an environment variable, Codex also documents http_headers.
- The free tier has a daily limit (see the pricing line above); a paid key raises it.
Swellmeter Trending in other clients
CursorVS Code (GitHub Copilot)Claude CodeClaude Desktop and claude.aiWindsurf (Devin Desktop)ClineGemini CLI
More MCP servers for OpenAI Codex CLI
AfterwrenAwardtide Recompete RadarBonafido: Business Domain Verification APICitewrenCommonkite: Free Image Search API, Creative Commons & CC0CyberMax DataDomainDNADutyfinchFeedpeck: RSS Feed Finder & Reader by WebsiteFieldwrightFigurewellHaulrollHireHeatInsidewellKevscopeLeafmeltLinkheftLogolark: Company Logo API & Favicon Finder by DomainMailvett: Email Validation API for AI AgentsNamewhereOrbitwrenPinloft: Batch Geocoder — Address to Lat/Long + Census FIPSPricewickPrintwren: HTML to PDF and URL to PDF (real Chrome)RecallrollShiftmoorSumbloomZiplore: US ZIP Code API (county, time zone, demographics, radius)
All Swellmeter Trending setups · All OpenAI Codex CLI setups · All