gitwtfhub

wtf is toolport-mcp-servers?

tsouth89/toolport-mcp-servers — explained in plain English

Analysis updated 2026-05-18

2JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

toolport-mcp-servers turns the public OpenAPI specs of Stripe, Vercel, and Clerk into full sets of AI-callable MCP tools with clearer, intent based names an AI agent can actually find.

Mindmap

mindmap
  root((toolport-mcp-servers))
    What it does
      Generates MCP tools
      From OpenAPI specs
      Intent friendly names
    Tech stack
      JavaScript
      Node.js
      OpenAPI
      MCP
    Use cases
      Stripe API access
      Vercel API access
      Clerk API access
    Extras
      Add custom vendors
      Optional Toolport layer

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an AI coding assistant direct access to the full Stripe, Vercel, or Clerk API as callable tools.

REASON 2

Generate a new intent-friendly MCP server for another vendor's OpenAPI spec.

REASON 3

Run a server in dry-run mode to inspect what HTTP requests each tool would send before adding a key.

What's in the stack?

JavaScriptNode.jsOpenAPIMCP

How it stacks up

tsouth89/toolport-mcp-servers3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-09-252021-02-06
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires an API key for the target service, such as Stripe or Vercel, to make real calls.

Permissive MIT license, use freely including for commercial purposes.

Wtf does this do

toolport-mcp-servers turns a company's public API description, called an OpenAPI spec, into a full set of tools an AI assistant can call directly. It currently ships ready made servers for three services: Stripe with 587 tools, Vercel with 333 tools, and Clerk with 224 tools. These are unofficial, generated from each vendor's published API documentation, and are not affiliated with Stripe, Vercel, or Clerk. The project uses the Model Context Protocol, or MCP, a standard way for AI tools like Claude Desktop or Cursor to connect to external services. You point your AI client at one of these servers with a single npx command and an API key for that service, and the assistant gets access to the entire API as individual callable actions, such as create_customer or list_organizations, instead of a handful of generic tools. The author explains that most automatically generated API tool sets end up with confusing names like PostCustomers or GetUsersUserIdOrganizationMemberships, which makes it hard for an AI model to figure out which tool to use for a given request. This project renames those tools into clearer, intent based names and writes richer descriptions using the actual vocabulary of each domain, such as charge, refund, and dispute for payments. The author reports this improves how often the right tool gets found in testing, citing a jump from 91 percent to 96 percent success on a benchmark of Stripe tools. Because exposing hundreds of tools at once can overwhelm an AI agent's context, the README also mentions a separate paid product called Toolport that can sit in front of these servers to let the agent search for tools on demand instead of loading all of them, and to require human approval before destructive actions like refunding a charge or deleting a deployment. The project also documents how to add new vendors by writing a small configuration file and running a prep script.

Yoink these prompts

Prompt 1
Show me how to set up the Stripe MCP server from toolport-mcp-servers in Claude Desktop.
Prompt 2
Explain how toolport-mcp-servers renames raw OpenAPI operation IDs into intent-friendly tool names.
Prompt 3
Walk me through adding a new vendor server to toolport-mcp-servers using the prep script.
Prompt 4
What is the difference between running these servers standalone versus behind Toolport?

Frequently asked questions

wtf is toolport-mcp-servers?

toolport-mcp-servers turns the public OpenAPI specs of Stripe, Vercel, and Clerk into full sets of AI-callable MCP tools with clearer, intent based names an AI agent can actually find.

What language is toolport-mcp-servers written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, OpenAPI.

What license does toolport-mcp-servers use?

Permissive MIT license, use freely including for commercial purposes.

How hard is toolport-mcp-servers to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is toolport-mcp-servers for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.