← all repositories
UsefulSoftwareCo/executor

A local switchboard for OpenAPI, GraphQL, and MCP

Executor exists so your AI agents can share one typed tool catalog instead of each reinventing glue for the same APIs.

2.5k stars TypeScript AgentsCoding Assistants
executor
Velocity · 7d
+20
★ / day
Trend
cooling
star history

What it does

executor is a local runtime that ingests API definitions—OpenAPI, GraphQL, MCP, Google Discovery, or anything with a JSON schema—and exposes them as a unified, typed tool catalog. AI agents query it by intent, inspect schemas, and invoke functions through a TypeScript runtime or by treating executor itself as an MCP server. It runs locally with a web UI and CLI, auto-manages a background daemon, and handles authentication and execution pauses for manual approval.

The interesting bit

Instead of baking Stripe, GitHub, or Gmail adapters into every agent, executor centralizes them in one plugin-based catalog that any MCP-compatible client can consume. It turns your laptop into a private integration hub—complete with intent-based discovery and automatic port fallback—so Cursor, Claude Code, and friends all draw from the same well.

Key highlights

  • First-class support for OpenAPI, GraphQL, MCP, and Google Discovery, with an open plugin system for anything JSON-schema-shaped.
  • Serves itself as an MCP server, letting compatible agents share one catalog, auth config, and policy set.
  • Typed TypeScript runtime with intent-based tool discovery and schema introspection.
  • Local daemon with automatic port selection and a web UI for adding sources interactively.
  • Executions can pause for auth or human approval and resume later via execution ID.

Caveats

  • The repository description promises a “secure environment,” but the README never details the sandboxing or isolation model.
  • “Policies” are mentioned as a shared asset, yet there is no explanation of how they are defined, enforced, or configured.

Verdict

Worth a look if you’re juggling multiple AI agents and tired of maintaining separate API adapters for each. Skip it if you need a managed, cloud-native integration platform—this is strictly localhost-first infrastructure.

Frequently asked

What is UsefulSoftwareCo/executor?
Executor exists so your AI agents can share one typed tool catalog instead of each reinventing glue for the same APIs.
Is executor open source?
Yes — UsefulSoftwareCo/executor is open source, released under the MIT license.
What language is executor written in?
UsefulSoftwareCo/executor is primarily written in TypeScript.
How popular is executor?
UsefulSoftwareCo/executor has 2.5k stars on GitHub and is currently cooling off.
Where can I find executor?
UsefulSoftwareCo/executor is on GitHub at https://github.com/UsefulSoftwareCo/executor.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.