Skip to content

connectors: batch 2a — 15 greenfield SaaS adapters (data, monitoring, time-tracking, social, support)#236

Merged
keysersoft merged 1 commit into
mainfrom
keysersoft/connector-batch-2
May 20, 2026
Merged

connectors: batch 2a — 15 greenfield SaaS adapters (data, monitoring, time-tracking, social, support)#236
keysersoft merged 1 commit into
mainfrom
keysersoft/connector-batch-2

Conversation

@keysersoft
Copy link
Copy Markdown
Contributor

Summary

Brings the connector catalog from 119 → 134 adapters (+15 greenfield). First slice of the next 50 — sized small so we can validate the pattern before the remaining 35 land.

Category New connectors
data openweather, coingecko, newsapi, hackernews
monitoring datadog, new-relic, bugsnag, uptime-robot
time-tracking harvest, toggl-track, clockify
social bluesky, mastodon
support gorgias, freshservice

All 15 are confirmed no vendor MCP (re-checked via `gh search repos` 2026-05-20).

What's in each adapter

  • Rich `instructions`: setup steps with credential URLs, auth model, ID discovery, pagination shape, rate limits, scope-out section.
  • Per-tool `description` that distinguishes neighboring tools (when to use X vs Y) — not just "calls /foo".
  • Parameter `description` on every field, marked required vs optional.
  • Static live spec (`*.live.spec.ts`) asserting baseUrl + auth shape. Same pattern as the prior 119.

Notable engine usage

  • `coingecko` uses optional `x-cg-demo-api-key` — works anonymous on the public tier, raises the rate limit when set.
  • `datadog` requires the dual `DD-API-KEY` + `DD-APPLICATION-KEY` pair via the API_KEY `extraHeaders` extension we added in batch 1.
  • `new-relic` wraps NerdGraph (GraphQL) NRQL queries through a REST POST to `/graphql` plus the legacy REST deployments endpoint.
  • `uptime-robot` uses QUERY_AUTH on `api_key + format=json` so each tool body stays clean form-encoded params (UR API accepts auth in URL).
  • `harvest, gorgias, freshservice, mastodon` use `{{}}` placeholders in baseUrl/headers so each tenant injects subdomain / account-id / instance at import time.
  • `toggl-track` uses the documented Basic auth pair (token, literal "api_token").
  • `bluesky` exposes session create + refresh so the JWT lifecycle is client-managed; subsequent tools take `access_jwt` as a tool param.

Verification

```
$ node scripts/validate-adapters.mjs
Validated 134 adapters: 134 passed, 0 failed.

$ npx jest --testPathPatterns='(openweather|coingecko|datadog|harvest|bluesky|mastodon|gorgias|freshservice|uptime-robot|new-relic|bugsnag|toggl-track|clockify|newsapi|hackernews).live.spec'
Test Suites: 15 passed, 15 total
Tests: 35 passed, 35 total

$ npx jest --testPathPatterns='adapters' --silent
Test Suites: 1 skipped, 97 passed
Tests: 26 skipped, 1941 passed, 1967 total
```

Test plan

  • CI green (validator + catalog-sync gate + jest)
  • Merge → trigger docker-publish.yml → deploy-cloud.yml
  • Verify `https://cloud.anythingmcp.com/api/adapters | jq 'length'` == 134
  • Spot-check a few of the new slugs: `/api/adapters/openweather`, `/api/adapters/datadog`, `/api/adapters/bluesky`
  • Confirm the pattern works end-to-end before opening batch 2b (remaining 35 connectors)

Out of scope (deferred to follow-up PRs)

  • Marketing guides (EN/DE/IT MDX) — separate PR on the website repo once this lands
  • ES/JA/RU/ZH translation fan-out — separate batch after guides
  • The remaining 35 of 50 — batched in PR 2b once this pattern is validated

Brings the catalog from 119 to 134 adapters. Each comes with rich
instructions, per-tool descriptions, parameter docs and a static live
spec asserting baseUrl + auth shape.

Categories covered:
  data:         openweather, coingecko, newsapi, hackernews
  monitoring:   datadog, new-relic, bugsnag, uptime-robot
  time-tracking: harvest, toggl-track, clockify
  social:       bluesky, mastodon
  support:      gorgias, freshservice

Notes:
- coingecko uses optional x-cg-demo-api-key (works anon for the public
  tier, raises rate limit when set).
- datadog requires the dual DD-API-KEY + DD-APPLICATION-KEY pair via
  the existing API_KEY extraHeaders extension.
- new-relic wraps NerdGraph (GraphQL) NRQL queries through a REST POST
  to /graphql plus the legacy REST deployments endpoint.
- uptime-robot uses QUERY_AUTH on api_key + format=json so each tool
  body stays clean form-encoded params (the API accepts auth in URL).
- harvest, gorgias, freshservice, mastodon use {{}} placeholders in
  baseUrl/headers so each tenant injects subdomain/account-id/instance
  at import time.
- toggl-track uses the documented Basic auth pair (token, "api_token").
- bluesky exposes session create + refresh so the JWT lifecycle is
  client-managed; subsequent tools take the access_jwt as a tool param.

All adapters validate via scripts/validate-adapters.mjs and 15/15 new
live specs pass (35 tests). Catalog regenerated.
@keysersoft keysersoft requested a review from D3nisty as a code owner May 20, 2026 18:41
@keysersoft keysersoft merged commit a9bf429 into main May 20, 2026
11 checks passed
@keysersoft keysersoft deleted the keysersoft/connector-batch-2 branch May 20, 2026 18:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant