Koskamo

Pymaia MCP

Pymaia is a growth analytics platform for LatAm ecommerce. Its MCP server allows AI assistants to read sales, ads, and store data from platforms like MercadoLibre, Tiendanube, Shopify, Meta Ads, and Google Ads. It provides actionable recommendations on what to improve first, such as pausing underperforming campaigns or fixing checkout steps, with actions requiring approval in the Pymaia app.

Endpoint and access

OAuth sign-in: the first time you connect, your client opens the vendor's own authorization prompt in a browser.

Pymaia MCP logo, by PymaiaVendor evidenceStreamable HTTPOAuth sign-inEndpoint checked 2026-10-26Operated by Pymaia
MCP endpoint (Streamable HTTP)
https://api.pymaia.com/mcp/directorio
Vendor documentation

About Pymaia MCP

This server integrates with the Pymaia growth analytics platform to retrieve performance metrics from LatAm ecommerce channels. It accesses data from MercadoLibre, Tiendanube, and Shopify for sales and product information, alongside Meta Ads and Google Ads for advertising performance.

The toolset focuses on analysis rather than direct execution. It identifies areas for improvement, such as underperforming campaigns or checkout issues, and suggests specific actions like pausing ads or adjusting budgets. Any implemented changes must be approved within the Pymaia application interface.

Connection requires OAuth authentication. Upon initial setup, the client triggers a browser-based authorization prompt managed by the vendor to establish the session.

What you can do with it

  • Read sales and product data from Tiendanube, Shopify, and MercadoLibre
  • Analyze Meta Ads and Google Ads performance metrics
  • Get weekly recommendations on what to improve in the store
  • Pause ad campaigns or adjust budgets via approval workflow

Source and maintenance

Vendor evidenceRegistry 3.0.0

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · registry · passed · metadata changed · Source metadata updated
  • · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http pymaia-mcp https://api.pymaia.com/mcp/directorio

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add pymaia-mcp --url https://api.pymaia.com/mcp/directorio

Cursor

Merge this server into .cursor/mcp.json in your project, then enable pymaia-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "pymaia-mcp": {
      "url": "https://api.pymaia.com/mcp/directorio"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "pymaia-mcp": {
      "type": "streamableHttp",
      "url": "https://api.pymaia.com/mcp/directorio",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start pymaia-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "pymaia-mcp": {
      "type": "http",
      "url": "https://api.pymaia.com/mcp/directorio"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http pymaia-mcp https://api.pymaia.com/mcp/directorio

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "pymaia-mcp": {
      "url": "https://api.pymaia.com/mcp/directorio"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "pymaia-mcp": {
      "serverUrl": "https://api.pymaia.com/mcp/directorio"
    }
  }
}

Let your agent find its tools

Find servers like Pymaia MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Frequently asked questions

Does the server execute ad changes automatically?
No. While the server suggests actions like pausing campaigns or modifying budgets, these operations require explicit approval in the Pymaia app. The server does not perform write operations directly.
Which advertising platforms are supported?
The server supports data retrieval from Meta Ads and Google Ads. It analyzes performance metrics from these sources to provide insights for LatAm ecommerce stores.
What is the authentication method?
Access is secured via OAuth sign-in. The first connection attempt opens a browser window displaying the vendor's authorization prompt to grant necessary permissions.

Do you run Pymaia MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing