Welcome to reShapr 🚀

Website | About | Docs | Blog | Community

✨ What is reShapr?

reShapr is the open source runtime that turns your existing APIs AI-Native, without rebuilding them. It bridges the gap between traditional REST/GraphQL/gRPC services and LLMs by transforming them into governed, discoverable, context-optimized MCP tools.

🧠 Solving the "Context Window" Problem

One of the biggest hurdles in building AI agents is Context Overload. Sending massive JSON responses to an LLM wastes tokens and degrades performance.

reShapr introduces Context Control

Related MCP server: rest2mcp

🌟 Key Features

• AI-Native Transformation: Auto-transform API services into LLM-friendly tools.

• Context Control: Filter and slim down payloads before they reach the LLM.

• Multi-Protocol: REST, GraphQL, and gRPC support.

• Zero Rewrite: Import an existing contract and get working MCP tools in minutes, with no bespoke MCP server per API.

📖 Full Documentation | Discord Community

Quick Start

Install the CLI

(Requires Node.js installed)

npm install -g @reshapr/reshapr-cli

Choose your platform

Choose how to get started:

1. Try it online: Use try.reshapr.io for a fully managed sandbox. Follow our Try reShapr online guide.

2. Run it locally (End-User): See the section below to spin up the latest published release.

3. Contribute code / launch the Web UI (Developer): Head to install/README.md to run the docker-compose stack — it uses :nightly development builds.

Run the platform locally

Assuming you have Docker installed, you can run the platform locally with the following command:

reshapr run

You should see a message like this:

ℹ️  Resolved 'latest' to release '1.0.0'.
ℹ️  Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/1.0.0/install/docker-compose-all-in-one.yml...
✅ Compose file saved to /Users/<you>/.reshapr/docker-compose-1.0.0.yml
ℹ️  Starting Reshapr containers (release: 1.0.0)...
✅ Reshapr containers started successfully.

Connect to the control plane at http://localhost:5555 with default credentials (admin/password):

reshapr login -s http://localhost:5555 -u admin -p password

Import an OpenAPI file:

reshapr import -u https://raw.githubusercontent.com/open-meteo/open-meteo/refs/heads/main/openapi/forecast.yml \
  --backendEndpoint https://api.open-meteo.com

You now have a fully functional MCP Server powered by reShapr at http://localhost:7777/mcp/reshapr/open-meteo-weather-forecast-api-1-0-default 🎉

You can try it out using an MCP client, explore the CLI and more features!

Build Status

The current development version is 1.0.1-SNAPSHOT.

Signature, Provenance, SBOM

Sonarcloud Quality metrics

LFX Insights

OpenSSF best practices

Contributing

We ❤️ contributors! Reshapr is an open community, and we welcome contributions of all kinds — not just code. Every contribution matters and helps make Reshapr better for everyone:

• 🐛 Report bugs or submit support requests via GitHub Issues

• 📖 Improve documentation — fix a typo, clarify a guide, or write a new tutorial

• 🧪 Write tests to increase coverage and reliability

• 🎥 Create demos or share your use cases with the community

• 💻 Submit code — bug fixes, features, or refactors are all welcome

• 💬 Share testimonials — tell us how you use Reshapr and help spread the word

📋 Before contributing, please read our Contributing Guide to learn about our development workflow, coding conventions, and how to submit your changes.

Come say hi on our Discord server — whether you have questions, ideas, or just want to chat with the community. We'd love to hear from you! 🚀

Support the project! 🌟

If you think reShapr is useful for the AI ecosystem, give us a star on our main repository! It helps us get more visibility and keep the project growing.

Thanks!