How to integrate Ganjoor using MCP

Read classic Persian poetry, poets, and Hafez fortunes. This guide creates an MCP server from Arthur's Ganjoor template — tools preconfigured against https://api.ganjoor.net — and finishes by sharing the server's MCP swagger documentation.

Steps

1. Go to the REST API Templates gallery and search for Ganjoor.

   

   

2. Click Use template on the Ganjoor card to open the server-creation dialog.

   

3. Review the server name — the dialog lists every tool that will be created.

   

4. Click Create server. Arthur creates the server, applies the authentication, and generates all the tools.

   

5. Open the server's Tools tab to review the generated tools.

   

6. Open the server's Connect section and click Share the MCP swagger documentation — Arthur generates the public documentation link and QR code for this server.

   

   

   

Confirm it worked

The server appears with 6 preconfigured tool(s): list_poets, get_poet, get_category, get_poem, get_random_poem, get_hafez_faal. The Connect section offers the MCP swagger documentation — a shareable page with setup instructions for any AI client.

Good to know

• Retrieve Ganjoor's catalog of classical Persian poets, categories (books), and individual poems with verses, recitations, images, and songs. All documented read routes are anonymous and require no API key.
• No authentication required — the server is ready to use immediately.
• Official API documentation: https://api.ganjoor.net/index.html
• Editing a tool later never changes the template — templates are starting points, and the server is fully yours after creation.

Related

• REST API Template Gallery
• How to Store and Reference a Secret
• How to Create a Server from a Template