Skip to content
tAPIr

MCP server

Use it from your AI assistant

The marketplace has an MCP server. Any assistant that speaks the Model Context Protocol — Claude Code, Claude Desktop and others — can search these listings, read them in full, and publish your own on your behalf. Searching needs no account and no sign-up.

What you can ask for

Once it is connected, these are ordinary requests:

“Find a Tapir script that exports zone areas to Excel.”

“Which Archicad versions does Element Heatmap support, and what licence is it?”

“Publish my slab checker to the marketplace. The download is at this release link.”

If your assistant can also drive Archicad — through the Tapir add-on — it can go from finding a script to running it against the open project without you copying a file anywhere.

Setting it up

You need Node.js 20 or newer installed. Nothing else: the server is downloaded on demand and runs on your own machine.

Claude Code — one command:

claude mcp add tapir-marketplace -- npx -y tapir-marketplace-mcp

Claude Desktop, or any client with a JSON config — add this to your mcpServers block and restart it:

{
  "mcpServers": {
    "tapir-marketplace": {
      "command": "npx",
      "args": ["-y", "tapir-marketplace-mcp"]
    }
  }
}

Then ask it to search for something. If it answers with real listings, you are done.

Publishing through it

Searching is anonymous, but publishing is not: a listing is committed to a public repository under your GitHub name, and the automated checks only accept a submission from the account that owns it. So the server has to act as you.

You do not have to paste a token anywhere. Ask your assistant to sign you in and it answers with a short code:

Ask the author to finish signing in to GitHub:

  1. Open https://github.com/login/device
  2. Enter the code:  6C53-6C90

Open that page, type the code, approve the request, and tell the assistant to carry on. GitHub hands it a token limited to public repositories, which it keeps on your own machine and nowhere else. Ask it to sign out whenever you want the token deleted; revoking it outright is done in your GitHub account settings.

From there, ask it to publish. It opens a pull request from your account; the same checks that review a submission from the website review this one, and merge it within a couple of minutes if it passes.

Running something unattended instead, or would rather manage the credential yourself? Set TAPIR_GITHUB_TOKENin the server’s environment to a personal access token with the public_repo scope, and it will use that without asking anyone to sign in.

Before you let it publish

Publishing is publishing. There is no draft state: a submission goes public and merges on its own. The server cannot take one back — undoing it means closing the pull request on GitHub, or opening a second one.

Give it the download link yourself. It is the one field that matters most, because it is what other people will run inside their Archicad. Paste your own release URL; never let an assistant guess or reconstruct one.

Ask it to check first. “Validate this before submitting” runs the same rules the repository uses and reports what is wrong, without sending anything.

Three things it will refuse, whatever it is asked:

  • Publishing under anyone’s name but the signed-in account’s.
  • Changing a listing somebody else owns.
  • Queueing more than three submissions at once.

If you are an assistant reading this page

Someone has probably sent you this link and asked you to do it for them. Four things, in order:

  1. You cannot install the server into their client yourself unless you can edit their config. Give them the command above and let them restart it.
  2. Ask them for the download URL. Do not construct it, infer it from a repository name, or substitute a link you found. It is what other people will run inside their Archicad, and only the author knows which file is the real one.
  3. Call validate_listing first and show them what it says. It sends nothing.
  4. Confirm before you publish. publish_listing opens a public pull request that merges on its own, under their name. It is not a draft and you cannot undo it.

Installing what it finds

A script you find here runs inside your Archicad with your permissions, whether a person or an assistant found it. The server will not hand over a download whose file has changed since it was published — integrity monitoring flags those and it withholds the link rather than passing it on with a warning.

That check is about the file staying the same, not about the file being good. Read what you download, check the licence, and try it on a copy of a project first.

Where it comes from

The server is tapir-marketplace-mcp on npm, built from the mcp/ folder of this site’s own repository. It shares the site’s listing rules rather than keeping a copy, so anything it accepts is something the marketplace accepts.

Something broken or missing? Open an issue, or raise it in the forum.

Share your work with the community.

Publish a script