Welcome to reShapr 🚀

Website | About | Docs | Blog | Community

✨ What is reShapr?

reShapr is the open source, no-code MCP Server for AI-Native API Access. It bridges the gap between traditional REST/GraphQL/gRPC services and LLMs by transforming complex services into discoverable, optimized MCP tools.

<p align="center"> <a href="https://reshapr.io/docs/tutorials/getting-started"> <img src="https://raw.githubusercontent.com/reshaprio/.github/main/assets/demo-video-github-full.gif" width="750" alt="reShapr Demo - Click to get started"> </a> <br> <em>✨ Transform any API into lean LLM contexts in seconds. </p>

[!IMPORTANT] To get involved with our community, please familiarize yourself with the project's Code of Conduct.

🧠 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

🌟 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.
No-Code: Configure and deploy in minutes.

📖 Full Documentation | Discord Community

Quick Start

Install the CLI

npm install -g @reshapr/reshapr-cli

Choose your platform

You have two simple options:

Use the https://try.reshapr.io/ to try out the platform. Follow our detailed Try reShapr online guide.
Run the platform locally using containers and Docker runtime. Follow the next section for details.

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 '0.0.8'.
ℹ️  Downloading compose file from https://raw.githubusercontent.com/reshaprio/reshapr/refs/tags/0.0.8/install/docker-compose-all-in-one.yml...
✅ Compose file saved to /Users/<you>/.reshapr/docker-compose-0.0.8.yml
ℹ️  Starting Reshapr containers (release: 0.0.8)...
✅ 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.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+APIs/1.0 🎉

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

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.

Reshapr

Install / Use

README