Is the Robskan API free?

Yes. The public read API and Product API MCP are free to use with anonymous rate limits.

Do I need an API key for public routes?

No. Documented GET routes and MCP product actions work without a key. OAuth is only for protected write namespaces.

Is there a sandbox or test mode?

Yes. Use the sandbox base at /sandbox (for example /sandbox/api/v1/health) or the fixtures under /api/v1/sandbox.

Where is the Product API MCP?

Streamable HTTP at /mcp (nl.robskan/product). Reference pages use /mcp/docs.

How do agents verify the Robskan API is live?

Call GET https://robskan.nl/api/v1/health — it returns JSON with status ok and links to OpenAPI.

Where is the Robskan OpenAPI spec?

https://robskan.nl/openapi.json documents all public REST routes.

Which MCP server is for product actions vs documentation?

Product MCP: https://robskan.nl/mcp/product (profile, Spotify). Docs MCP: https://robskan.nl/mcp/docs (llms indexes, markdown).

Developers

Public, anonymous read APIs for Robbie's portfolio and live Spotify listening. No API keys required — respect rate limits.

Robskan API

curl https://robskan.nl/api/v1/health
curl https://robskan.nl/api/v1/profile
curl https://robskan.nl/api/v1/music/now-playing
curl https://robskan.nl/openapi.json

Robskan API documentation

OpenAPI 3.1
auth.md — agent authentication walkthrough
llms.txt — agent navigation index
plugin.json — Agent Plugins manifest
pricing.md — free public API and MCP
Cursor MCP example config
wikidata-setup.md — entity linking for Is Agentic
Publishing checklist (npm, PyPI, MCP registry): see docs/AGENT_PUBLISHING.md in the repo after deploy
npm SDK: robskan (see OpenAPI x-official-sdk-npm)
CLI: npx robskan health

Robskan MCP

Two MCP servers: product (live portfolio data) and documentation (read/search site docs).

Robskan MCP (documentation)

Documentation MCP: read llms indexes, page markdown, and search site docs. Tools: Documentation MCP tools: search_docs, read_doc_page, list_doc_pages.

HTTP: https://robskan.nl/mcp/docs
Server card: /.well-known/mcp/docs-server-card.json

Robskan MCP (product)

Product MCP: HTTP: https://robskan.nl/mcp (alias https://robskan.nl/mcp/product, not advertised)

Tools: compute_year_progress, lookup_project_status, pull_now_playing_snapshot, create_listening_summary, verify_http_route.

HTTP: https://robskan.nl/mcp (alias https://robskan.nl/mcp/product)
Server card: /mcp/server-card

Robskan MCP registry

Combined registry: /.well-known/mcp/server-card.json
Documentation MCP: https://robskan.nl/mcp/docs
Product MCP: https://robskan.nl/mcp/product

Sandbox test mode

Use the sandbox base https://robskan.nl/sandbox for safe test mode fixtures (same /api/v1/... paths). OpenAPI lists server Sandbox test mode at https://robskan.nl/sandbox. Legacy index: https://robskan.nl/api/v1/sandbox (X-Robskan-Environment: sandbox).

curl https://robskan.nl/sandbox/api/v1/health
curl https://robskan.nl/sandbox/api/v1/profile
curl -H "X-Robskan-Sandbox: 1" https://robskan.nl/api/v1/health

MCP bad-tool probe (requires Accept header): curl -X POST https://robskan.nl/mcp/docs -H "Accept: application/json, text/event-stream" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"unknown_tool","arguments":{}}}'