npm install @aplicious/mcp-server

APlicious for AI Agents

Give Claude, Cursor, Windsurf, and any MCP-compatible AI direct access to 125+ live endpoints across 10 namespaces — one line of config.

125+ endpoints

Claude · Cursor · Windsurf

3 tools, zero friction

Free plan available

Get Free API Key View on npm

How it works

The MCP server runs locally, bridges your AI client to APlicious's live APIs, and exposes three tools the AI uses automatically — no code required on your end.

You ask the AI

Say "What's the live bitcoin price?" or "Calculate my BMI" in natural language.

AI calls the MCP

The AI invokes list_apis, get_api_spec, then call_api with the right parameters.

Live data returned

APlicious responds with real data. The AI weaves it into a natural reply.

Three tools. Everything the AI needs.

The server exposes exactly three MCP tools — lean, composable, and self-documenting.

list_apisDISCOVER

Browse all 125+ endpoints by namespace or keyword. Returns a grouped, readable list with summaries so the AI knows what's available.

// Example invocation
list_apis({ keyword: "crypto" })

// Returns
FINANCE (3)
  GET  /api/v1/finance/crypto/price     — Cryptocurrency price
  GET  /api/v1/finance/crypto/list      — List top cryptocurrencies
  GET  /api/v1/finance/crypto/history   — Cryptocurrency price history

get_api_specINSPECT

Get full parameter spec for any endpoint — required vs optional, types, enums, defaults, and examples. The AI calls this before calling the API to avoid errors.

// Example invocation
get_api_spec({ path: "/api/v1/wellness/bmi", method: "GET" })

// Returns
GET /api/v1/wellness/bmi
**BMI calculator**

### Query Parameters
- `weight` (number) *(required)*: Body weight — example: `70`
- `height` (number) *(required)*: Height in cm — example: `175`
- `unit` (string) *(optional)*: Unit system — allowed: `metric | imperial`

call_apiEXECUTE

Call any live APlicious endpoint with your API key and return real data. Handles both GET (query params) and POST (JSON body) requests with actionable error messages.

// Example invocation
call_api({
  path: "/api/v1/wellness/bmi",
  method: "GET",
  params: { weight: 70, height: 175, unit: "metric" }
})

// Returns
200 OK

{
  "success": true,
  "data": {
    "bmi": 22.9,
    "category": "Normal weight",
    "healthy_range": { "min": 18.5, "max": 24.9 }
  }
}

Quick install

No global install needed. npx runs the server on demand — always the latest version.

Get a free API key

250 free calls per month, no credit card required. Your key starts with lapi_live_.

Create free account →

Choose your AI client

Click your client below to see the exact config to paste. Replace lapi_live_your_key_here with your real key.

Restart your AI client

After saving the config, restart your client. Look for aplicious in the MCP tools panel — or just ask the AI a question that needs live data.

Ask anything

No special syntax. Just talk to your AI naturally.

“What's the current bitcoin price and 24h change?”

“Calculate my BMI — I'm 72kg and 178cm tall.”

“Show me the head-to-head record between India and Australia in T20s.”

“What are the top high-protein foods in the USDA database?”

“Give me a circadian schedule for a 6:30am wake time.”

“What remote Python jobs are available right now?”

“Calculate the EMI on a ₹50 lakh home loan at 8.5% for 20 years.”

Manual install (optional)

If you prefer a local install over npx, or want to pin a specific version:

Terminal

npm install -g @aplicious/mcp-server

Then replace npx with the full path to aplicious-mcp in your client config.

Environment variables

Variable	Required	Description
`APLICIOUS_API_KEY`	Required	Your APlicious API key. Starts with lapi_live_. Get one free at aplicious.com/auth
`APLICIOUS_BASE_URL`	Optional	Override the API base URL. Defaults to https://aplicious.com. Useful for local dev.

What the AI can access

Every namespace below is available immediately — one key, all 125+ endpoints.

🏃Wellness18 endpoints

BMI · sleep cycles · fasting · stress · dosha · mood

🥗Food9 endpoints

USDA search · nutrients · meal calculator · diet filters

🍳Recipes5 endpoints

100+ recipes · by cuisine · by diet · random

🏏Sports10 endpoints

22k cricket matches · football · F1 · basketball · hockey

🎓Education11 endpoints

universities · courses · scholarships · quiz generator

📈Finance30 endpoints

stocks · crypto · forex · SIP · EMI · options Greeks

⚖️Legal6 endpoints

NDA generator · GDPR checklist · jurisdiction data

🏠Property4 endpoints

amortization · stamp duty · rent vs buy · rental yield

💼Jobs8 endpoints

remote jobs · salary · career paths · skills gap

⚙️Tools20 endpoints

OCR · transcription · TTS · PDF · image · QR · translate · sentiment

Troubleshooting

The MCP server doesn't appear in my client

Make sure you saved the config file and fully restarted the client (not just refreshed). Check that Node.js ≥18 is installed: node --version.

I get a 401 Unauthorized error

Your APLICIOUS_API_KEY is missing or incorrect. Copy your key from aplicious.com/dashboard and paste it exactly — it starts with lapi_live_.

I get a 429 Too Many Requests error

You've hit your monthly call quota. The Free plan includes 250 calls/month. Upgrade at aplicious.com/pricing.

npx is slow on first run

npx downloads the package the first time. Subsequent runs use the npm cache and start instantly. Use npm install -g @aplicious/mcp-server for a permanent install.

The AI calls the wrong parameters

Ask the AI to call get_api_spec first: "Check the spec for /api/v1/wellness/bmi before calling it." The MCP is designed to do this automatically.

🚀

Ready to give your AI real-world data?

Get your free API key, paste one config block, and your AI agent has live access to 125+ endpoints in under 2 minutes.

Get Free API Key API Reference