{"id":"clue-json-server","name":"json-server","homepage":"https://hub.docker.com/r/clue/json-server","repo_url":"https://hub.docker.com/r/clue/json-server","category":"devtools","subcategories":[],"tags":["devtools","mock-server","rest-api","crud","nodejs"],"what_it_does":"json-server is a development tool that serves a full fake REST API from a local JSON file (or multiple files) by exposing typical CRUD endpoints for your data.","use_cases":["Prototyping frontend apps against a mock backend","Building demos and sandboxes without implementing a real backend","Testing UI flows that depend on REST endpoints","Quickly creating CRUD endpoints from sample data"],"not_for":["Production-grade backends (no real persistence/DB guarantees)","Complex API behaviors that require business logic, auth, or multi-tenant rules","Strict contract-driven APIs requiring comprehensive documentation generation"],"best_when":"You need fast, local or lightweight mock REST endpoints backed by static JSON data.","avoid_when":"You need secure multi-user access control, durable data storage, or strict error/response contracts for production.","alternatives":["jsonplaceholder","typicode (typical mock APIs)","MirageJS","Mock Service Worker (MSW) for frontend mocking","Low.js or custom Express mock servers","Use a real backend with SQLite/Postgres and a proper ORM"],"af_score":49.5,"security_score":27.5,"reliability_score":33.8,"package_type":"mcp_server","discovery_source":["docker_mcp"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:48:07.899055+00:00","interface":{"has_rest_api":true,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"By default json-server does not provide authentication/authorization; it is primarily for local development/mocking."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source tooling typically run locally; costs are your infrastructure/runtime rather than service pricing."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":49.5,"security_score":27.5,"reliability_score":33.8,"mcp_server_quality":0.0,"documentation_accuracy":60.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":50.0,"auth_strength":0.0,"scope_granularity":0.0,"dependency_hygiene":50.0,"secret_handling":50.0,"security_notes":"Security posture is minimal by design: no auth/authz by default, so it should be run only in trusted environments (local dev/CI). TLS depends on how you run/host it; json-server itself is not an auth gateway.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":50.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["json-server is a mock server; behavior may not match a real production API (especially auth, validation, and complex constraints).","CRUD endpoints depend on your JSON shape; agents should derive endpoint paths from the loaded data/schema rather than assume a fixed contract.","No first-class idempotency guarantees are documented for writes; retries may create duplicates depending on your data and request strategy."]}}