Documentation
Get started with documentation and helpful guides
for using the PestoMCP developer API, embedding the PestoMCP button, and more
Getting started with PestoMCP
IMPORTANT! Before using the PestoMCP API, embeddable button, or other tools, make sure you have an active account and subscription plan with PestoMCP and that your MCP server published and live
After you signup to PestoMCP, you can log into your account with your email and password. The console allows you to launch MCP servers, integrate your website, manage settings, and more.
Once you completed the setup wizard, launch a new MCP sever, and publish your first version, your MCP server will be live. You can review, edit, publish, and unpublish versions from the console. You can also add author profiles to versions or set a default author profile on all new versions.
Keep in mind that only published versions of your MCP server will be available to AI agents and LLMs online
The PestoMCP console also lets you manage settings such as MCP payment processing, auto-publish settings, as well as invite team members to collaborate with different permissions. To log in to the console, visit the following link:
If your website is hosted using Wordpress, Shopify, or Wix, you can easily install the PestoMCP plugin/app. The PestoMCP plugin/app will launch an MCP Server that is based on information and supported features of your website
PLEASE NOTE: If you make updates to your website you will need to generate a new version of your MCP server to mirror these changes in MCP. Alternative you can set Auto-publish on to have this occur automatically
To install the PestoMCP plugin/app, make sure you are logged in to your Wordpress/Shopify/Wix account and visit our plugin/app page:
The PestoMCP API allows interaction with the service, offering two main RESTful API endpoints: one to retrieve a list of published versions, and another to retrieve details for a specific version. API responses are in JSON format.
AUTHORIZATION:
HEADER 'x-api-key' : YOUR_API_KEY
To make authorized API requets, use the API Key for your site as the value for the 'x-api-key' header. The API Key can be found in the PestoMCP console site settings for that site. Each site has a different API Key.
You can find your API key and site ID by logging into your PestoMCP account, and then navigating to the site settings
GETTING THE LIST OF PUBLISHED VERSIONS:
GET https://api.pestomcp.com/v1/getversionsforsite
Retrieves the list of versions that have been generated and published for you MCP server.
Only published versions will be returned by the API. You can publish a version from the PestoMCP console or, if your MCP is connected your website, you can turn on auto-publish to have versions published automatically when your website changes
Example request properties:
"site_id": "YOUR_SITE_ID", //You can find your site id in the site settings in the PestoMCP console
"response_format": "json",
"limit": 10, //The number of versions you want to be returned in one page
"start_key": "LAST_KEY" || null, //This is used to get the next page of versions
Example response:
{
"posts": [
{
"site_id": "SITE_ID",
"post_id": "POST_ID", //This is a unique ID of the version
"title": "POST_TITLE",
"lookup_id": "LOOKUP_ID",
"published_time": "JAVASCRIPT_DATE",
"version": "VERSION_NUMBER", //The version number
"mcp_url": "MCP_URL", //The link to the MCP service for this version
"image_url": "VERSION_IMAGE_URL", //If you added an image to the version
}
],
"lastKey": "LAST_KEY", //This is used to get the next page of versions by supplied it as the start_key in the next request
"response_format": "json"
}
GETTING THE DETAILS OF A VERSION:
GET https://api.pestomcp.com/v1/getversion
Retrieves details for a specific version. Expects request body with site_id, post_id, and response_format (json only).
Example request properties:
"site_id": "SITE_ID", //This will be on each version that was retrieved via the getversionsforsite API
"post_id": "POST_ID", //This will be on each version that was retrieved via the getversionsforsite API
"response_format": "json"
Example response:
{
"site_id": "SITE_ID",
"post_id": "POST_ID", //This is a unique ID of the version
"title": "VERSION_TITLE",
"lookup_id": "LOOKUP_ID",
"published_time": "JAVASCRIPT_DATE",
"image_url": "VERSION_IMAGE_URL", //If you added an image to the version
"content": "VERSION_CONTENT", //A description of the MCP service for this version
"change_log": "VERSION_CHANGELOG", //A change log of the version
"version": "VERSION_NUMBER", //The version number
"mcp_url": "MCP_URL", //The link to the MCP service for this version
"author" = {
"id": "PROFILE_ID",
"name": "FULL_NAME",
"image_url": "PROFILE_IMAGE_URL", //null if it does not exist
"social_url": "PROFILE_SOCIAL_URL", //null if it does not exist
"bio": "PROFILE_SOCIAL_URL", //null if it does not exist
},
"response_format": "json"
}
PestoMCP has convenient iOS and Android apps that allow you to easily manage your MCP servers on the go. The apps have all the important funcitonlity that the web console has including the ability to create new versions. To use the apps on your iPhone or Android device simply download them from the Apple App Store or Google Play Store.
PLEASE NOTE: The iOS app may not have billing management depending on your country. If you need to manage billing, please do so from the PestoMCP web console