Reshapr

The open source, no-code MCP Server for AI-Native API Access.

• Documentation
• Join us on Discord

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

Quick Start

Install the CLI

npm install -g @reshapr/reshapr-cli

Choose your platform

You have two simple options:

1. Use the https://try.reshapr.io/ to try out the platform. Follow our detailed Try reShapr online guide.
2. 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! 🚀

Thanks!