JustIdea Agency Developers

JustIdea Agency developer portal

Search and read the public website of JustIdea Agency, list its services with the published starting prices and get contact options, over a REST API or an MCP server. Free and read-only, with no sign-up and no API key. Your first call takes one line.

Quickstart

1. Make your first call, no key needed

curl "https://justidea.agency/api/v1/search?q=prestashop&lang=en"
curl "https://justidea.agency/api/v1/services?lang=en"

Responses are JSON. GET /api/v1/page?url=<url> returns one page with its full text as Markdown. Every endpoint, parameter and schema is in the OpenAPI 3.1 description (also as YAML).

2. Or connect an MCP client

The MCP server at https://justidea.agency/mcp speaks Streamable HTTP (JSON-RPC over POST), protocol 2025-11-25 and older. It needs no authentication and keeps no session.

{
  "mcpServers": {
    "justidea": {
      "type": "http",
      "url": "https://justidea.agency/mcp"
    }
  }
}
claude mcp add --transport http justidea https://justidea.agency/mcp

Without an SDK, one JSON-RPC request is enough:

curl -s https://justidea.agency/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_site","arguments":{"query":"PrestaShop migration"}}}'

3. Optional: get an access token yourself

A token identifies your agent and raises the REST API limit from 120 to 600 requests per minute. One request, no account, no e-mail, no approval:

curl -s -X POST https://justidea.agency/agent/auth/ \
  -H "Content-Type: application/json" \
  -d '{"type":"anonymous"}'

Send credential from the response as a bearer token, to the API or to the MCP server, and check who you are:

curl -s https://justidea.agency/api/v1/identity \
  -H "Authorization: Bearer <credential>"

Access, keys and limits

Without a tokenWith a token
Rate limit (REST API)120 requests per 60 seconds per IP address600 requests per 60 seconds per agent
How to get itNothing to doPOST /agent/auth/, one request
LifetimeAlways onAccess token 1 hour, identity assertion 30 days
ScopeEvery endpoint and toolThe same: site:read

Reference

REST API

Base URL https://justidea.agency/api/v1, version 1. Every GET also answers HEAD. CORS is open, so the API works from a browser too.

MethodPathReturns
GET/api/v1API description with every endpoint URL
GET/api/v1/healthHealth: version, number of pages, languages
GET/api/v1/search?q=&lang=&type=&limit=Pages matching a query
GET/api/v1/pages?type=&lang=&limit=&cursor=Pages with cursor pagination
GET/api/v1/page?url=One page as Markdown
GET/api/v1/services?lang=Services with published starting prices (PLN or EUR)
GET/api/v1/contact?lang=E-mail, phone and contact page
GET/api/v1/identityThe agent behind the bearer token (token required)
POST/api/v1/batchUp to 10 GET operations in one request

MCP tools

Server https://justidea.agency/mcp, version 1.1.0. These tools are annotated read-only:

ToolWhat it does
list_servicesList JustIdea Agency services with the published starting ("from") prices and links.
get_pageFull text of one justidea.agency page as Markdown: a service, a price list, the company profile, reviews, a blog article.
search_siteSearch justidea.agency pages by titles, descriptions and section headings.

send_inquiry is not read-only: it passes a person's inquiry to the sales team. Call it only when the user asks to get in touch, with their own contact details and explicit consent.

scan_analytics and scan_ai_visibility run a free scan of the user's own website (analytics and tracking, or visibility in AI assistants). They need the user's e-mail and explicit consent: you get the grade and the list of problems, and the full report with fixes is e-mailed to the user. Limit: 2 scans per e-mail address per day. get_scan_result returns the result of a scan that took longer than one call.

MCP resources

Documentation

Testing and sandbox

There is no separate sandbox or test mode, and you do not need one. Every REST endpoint and every MCP tool except send_inquiry and the scan tools only reads the public website, has no side effects and is safe to call and retry as often as the rate limit allows. Test against production: the same URLs you will use live.

Errors and versioning

What the API does not do

The REST API never submits forms, books meetings, sends messages or takes payments, and it holds no client data. It returns only prices published on the website: net starting prices, the final quote depends on scope. When a person wants to get in touch, give them the link, e-mail address or phone number from GET /api/v1/contact.

Support