MCP Project Planner

A remote Model Context Protocol server that lets any MCP client (Claude Desktop, Cursor, and others) plan a project from PinoyFreeCoder's curated catalogs. Describe what you want to build — for example, "Build me a SMS SaaS platform" — and it searches the GitHub Finds and Public APIs directories, then returns matched open-source repos, relevant APIs, and a suggested cost-efficient tech stack. Your AI writes the code; this server supplies the building blocks.

No authentication, no API key, and no server-side LLM cost: the tool only searches and ranks the existing bundled data.

Endpoint

https://pinoyfreecoder.com/api/mcp

Streamable HTTP transport. The handler serves every request at this path; it does not require session state.

Install & connect

Claude Code (CLI)

One command registers the server across all your projects:

claude mcp add --transport http --scope user pinoyfreecoder https://pinoyfreecoder.com/api/mcp

Drop --scope user to add it only to the current project.

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude:

{
  "mcpServers": {
    "pinoyfreecoder": {
      "type": "http",
      "url": "https://pinoyfreecoder.com/api/mcp"
    }
  }
}

Cursor

Add the server to .cursor/mcp.json in your project (or the global config), then reload:

{
  "mcpServers": {
    "pinoyfreecoder": {
      "url": "https://pinoyfreecoder.com/api/mcp"
    }
  }
}

Any other MCP client

Point it at https://pinoyfreecoder.com/api/mcp. No credentials are required.

Tools

plan_project

The primary tool. Give it a project idea and it returns matched repos, APIs, and a suggested stack.

Input

Field	Type	Notes
prompt	string (3–500)	What the user wants to build.
maxResults	number (1–20)	Optional. Repos/APIs per group (default 6).

Output (structuredContent)

{
  "prompt": "Build me a SMS SaaS platform",
  "suggestedStack": [
    {
      "layer": "Backend / Infrastructure",
      "choice": "httpsms",
      "why": "Self-hostable, so no per-seat SaaS cost.",
      "source": "github-finds",
      "url": "https://github.com/NdoleStudio/httpsms"
    },
    {
      "layer": "External API",
      "choice": "...",
      "why": "No authentication required — fastest and cheapest to integrate.",
      "source": "public-apis",
      "url": "..."
    }
  ],
  "repos": [
    { "name": "...", "repo": "...", "url": "...", "categories": [], "description": "...", "score": 12.5 }
  ],
  "apis": [
    { "name": "...", "url": "...", "categories": [], "auth": "none", "https": "yes", "cors": "yes", "description": "...", "score": 8.0 }
  ],
  "notes": "Ranking favors no-auth APIs and self-hosted repos ..."
}

search_github_finds

Search the curated open-source project catalog.

Input

Field	Type	Notes
query	string (1–200)	Keywords.
category	string	Optional. One of ai, security, devtools, self-hosted, learning, frontend, productivity, media, networking.
limit	number (1–50)	Optional (default 10).

search_public_apis

Search the Public APIs directory with optional filters.

Input

Field	Type	Notes
query	string (1–200)	Keywords.
category	string	Optional. Exact imported category label.
auth	string	Optional. none, apiKey, oauth, header, other, unknown.
https	string	Optional. yes, no, unknown.
cors	string	Optional. yes, no, unknown.
limit	number (1–50)	Optional (default 10).

Ranking & cost efficiency

Matches are scored by weighted keyword hits — name matches count most, then categories, then description — plus a small bonus for the cheapest options to run: no-auth APIs and self-hosted repos. Domain words that don't appear literally in the data (for example, "SMS", "payments", "dashboard") are expanded to related categories so broad prompts still surface useful results.

Rate limiting

Calls are rate limited per client origin (fixed window). When the limit is reached, tools return a plain "rate limit reached, try again in N seconds" message rather than an error.

Data source & caveats

Results come from PinoyFreeCoder's curated catalogs:

• GitHub Finds — hand-picked open-source projects.
• Public APIs — a local snapshot of the community public-apis/public-apis directory (see public-apis-directory.md for how it is refreshed).

Badges (auth, https, cors) reflect the source at import time, not live checks. Verify current pricing, availability, and requirements with each provider before building.