{"id":50723589,"url":"https://github.com/pipeworx-io/windsurf-plugin","last_synced_at":"2026-06-10T02:03:32.095Z","repository":{"id":360031482,"uuid":"1237993856","full_name":"pipeworx-io/windsurf-plugin","owner":"pipeworx-io","description":"Pipeworx install kit for Windsurf (Cascade) — connects to 1,423+ live data tools across 392+ packs via the Pipeworx MCP gateway.","archived":false,"fork":false,"pushed_at":"2026-06-02T04:04:17.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T04:06:22.502Z","etag":null,"topics":["cascade","mcp","mcp-server","model-context-protocol","pipeworx","windsurf"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pipeworx-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T17:54:38.000Z","updated_at":"2026-06-02T04:04:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pipeworx-io/windsurf-plugin","commit_stats":null,"previous_names":["pipeworx-io/windsurf-plugin"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pipeworx-io/windsurf-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pipeworx-io%2Fwindsurf-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pipeworx-io%2Fwindsurf-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pipeworx-io%2Fwindsurf-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pipeworx-io%2Fwindsurf-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pipeworx-io","download_url":"https://codeload.github.com/pipeworx-io/windsurf-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pipeworx-io%2Fwindsurf-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34133406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cascade","mcp","mcp-server","model-context-protocol","pipeworx","windsurf"],"created_at":"2026-06-10T02:03:30.792Z","updated_at":"2026-06-10T02:03:32.083Z","avatar_url":"https://github.com/pipeworx-io.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pipeworx for Windsurf\n\nGive Cascade one MCP that reaches **3,300+ live-data tools across 750+ sources** — SEC filings, USPTO patents, FRED, Census, FDA, EPA, USAspending, Polymarket, Zillow, weather, and 740+ more — without loading 3,300+ tool schemas into your context window.\n\n## Install\n\nWindsurf doesn't currently expose a public plugin submission format, so this is a copy-paste install kit.\n\n**1. Add Pipeworx to your global Windsurf MCP config.** Open (or create) `~/.codeium/windsurf/mcp_config.json` and merge in:\n\n```json\n{\n  \"mcpServers\": {\n    \"pipeworx\": {\n      \"serverUrl\": \"https://gateway.pipeworx.io/pipeworx-catalog/mcp\"\n    }\n  }\n}\n```\n\n**2. Restart Cascade** (or hit Refresh in Windsurf's MCP settings). You should see `pipeworx` connected with ~26 tools.\n\n**3. (Recommended) Drop the routing rule into your project.** Copy `.windsurf/rules/pipeworx.md` from this repo into your project's `.windsurf/rules/` directory. Or for global use, paste its contents into `~/.codeium/windsurf/memories/global_rules.md`. The rule teaches Cascade when to reach for `ask_pipeworx` / `discover_tools` instead of hand-writing facts.\n\n## Try it\n\nAfter install, ask Cascade things like:\n\n| Ask | What it triggers |\n|---|---|\n| *\"What just happened to Apple?\"* | `sec_8k_recent` → SEC 8-K events classified by severity |\n| *\"Spread between Polymarket and Kalshi on the next Fed decision?\"* | `polymarket_kalshi_spread` → live cross-venue mispricing |\n| *\"Overdue Phase 3 readouts at Moderna?\"* | `pharma_pipeline_catalysts` → biotech catalyst calendar |\n| *\"DoD cybersecurity contracts this week?\"* | `usa_award_search` → sub-second USAspending mirror |\n| *\"Median home value and renter share in Lubbock, TX?\"* | `housing_market_snapshot` + `housing_metro_demand` |\n| *\"Unemployment rate last month?\"* | `fred_get_series` → official FRED data |\n\nCascade picks the right tool via `ask_pipeworx` — no pack-name memorization required.\n\n## How it loads light\n\nThe install exposes **~26 meta-tools**, not all 3,300+ — `ask_pipeworx({question})` and friends route at runtime so you get the full catalog without the context tax.\n\n## Free tier + signup\n\n50 calls/day anonymous, IP-bound. [Sign up free in 10s via GitHub](https://pipeworx.io/signup?via=windsurf_plugin) for 200/day + a stable account.\n\n## Verify after install\n\nTry a real query in Cascade:\n\n\u003e What was the unemployment rate last month?\n\n## What's loaded\n\n- **`ask_pipeworx`** — natural-language router across all 750+ sources.\n- **`discover_tools`** — top-20 relevant tools for a task, with full schemas.\n- **`entity_profile`** / **`compare_entities`** / **`recent_changes`** / **`resolve_entity`** — fan-out across multiple packs in one call.\n- **`validate_claim`** — fact-check claims against SEC XBRL.\n- **`remember`** / **`recall`** / **`forget`** — persistent memory across sessions.\n- **`list_packs`** / **`search_packs`** / **`get_pack_tools`** / **`get_connection_config`** / **`get_platform_status`** / **`search_mcp_directory`** — browse the catalog.\n\n## Direct pack access\n\nFor a specific pack's tools loaded directly (e.g., `attom_property_search`), add a scoped entry to `mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"pipeworx-attom\": {\n      \"serverUrl\": \"https://gateway.pipeworx.io/attom/mcp\"\n    }\n  }\n}\n```\n\n## Bring your own key\n\nFor BYO-tier (200/day), add `?_apikey=YOUR_KEY` to `serverUrl` (Windsurf's remote-MCP config doesn't reliably honor headers yet across versions).\n\n## Submitting to Windsurf's Plugin Store\n\nWindsurf curates the in-app MCP marketplace; no public submission spec yet. When Codeium opens it up, we'll publish here and link from https://pipeworx.io.\n\n## Links\n\n- Gateway: https://gateway.pipeworx.io\n- Status: https://pipeworx.io/status\n- Source: https://github.com/pipeworx-io/pipeworx\n\n## License\n\nMIT\n\n---\n\n⭐ Star if you'd use this — helps other Windsurf users discover it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpipeworx-io%2Fwindsurf-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpipeworx-io%2Fwindsurf-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpipeworx-io%2Fwindsurf-plugin/lists"}