Developer Resources

Everything developers and AI agents need to integrate with Cost-Effective Software (costeffective.software): API documentation, our OpenAPI specification, the public MCP server, authentication details and machine-readable site content.

REST API

Public HTTP endpoints, versioned under /api/v1/ and formally described by our OpenAPI specification. Zero-auth, rate-limited at 60 req/min with IETF RateLimit headers.

  • OpenAPI 3.1 specification

    Machine-readable description of every public endpoint with typed request, response and error schemas, plus the versioning and deprecation policy.

    https://www.costeffective.software/openapi.json

  • Health endpoint (v1)

    Service status check. Returns {"status":"ok"}.

    https://www.costeffective.software/api/v1/health

MCP server

A public, read-only Model Context Protocol server for AI agents (Streamable HTTP).

  • MCP endpoint

    Tools: get_company_overview, list_industries, get_contact_info, request_consultation. No authentication required.

    https://www.costeffective.software/mcp

  • MCP manifest

    Standard manifest describing the transport and available tools (also served as an SEP-1649 server card at /.well-known/mcp/server-card.json).

    https://www.costeffective.software/.well-known/mcp.json

Content for agents

Machine-readable renditions of the site — no JavaScript or HTML parsing required.

  • llms.txt

    Guide to this site for AI agents and LLM crawlers.

    https://www.costeffective.software/llms.txt

  • agents.md

    Agent instructions: when to use Cost-Effective Software and how to call us (MCP, REST, booking).

    https://www.costeffective.software/agents.md

  • Markdown mirrors

    Every public page as markdown at /md/{path} (e.g. /md/careers, /md for the homepage). Pages also honour Accept: text/markdown.

    https://www.costeffective.software/md

  • Sitemap

    XML sitemap of every public page.

    https://www.costeffective.software/sitemap.xml

  • API catalog

    RFC 9727 catalog (linkset) of our APIs and their documentation.

    https://www.costeffective.software/.well-known/api-catalog

Authentication

How agents and integrations authenticate with protected services.

  • auth.md

    Agent authentication guide: public endpoints, OAuth 2.0 / OIDC metadata and registration.

    https://www.costeffective.software/auth.md

  • OAuth authorization server metadata

    RFC 8414 authorization server metadata for protected APIs.

    https://www.costeffective.software/.well-known/oauth-authorization-server

Programmatic access

Open client registration is not offered yet. To request API access for an autonomous agent or integration, email team@costeffective.software with your use case — see auth.md for the full authentication guide.