Skip to main content

:::warning AUTO-GENERATED — do not edit This page is generated from the MCP server snapshot content/guide-angular-mcp.json. Edit the source MCP server (not this file), then run npm run generate. :::

Find the right API endpoint (do this before any data work)

When to use: You need data from the backend and must confirm the exact endpoint, params, and response shape before writing an HttpClient service.

Prerequisites​

  • The rystad-api MCP server is connected.
  • You know the business domain you need (e.g. 'wells', 'production', 'companies').

Steps​

Step 1: List what backends exist so you target the right microservice.​

Tools: list_microservices

Step 2: Search for endpoints matching your domain keyword.​

Tools: search_endpoints

Step 3: Get the full contract for the chosen endpoint.​

Tools: get_endpoint_details

Step 4: Confirm the endpoint exists before writing any code.​

Tools: validate_endpoint

Step 5: Get the gateway proxy path + auth requirements for this project.​

Tools: get_gateway_pattern, get_auth_requirements

Full recipe definition​

The complete machine-readable recipe as returned by the MCP server:

{
  "id": "discover-api",
  "title": "Find the right API endpoint (do this before any data work)",
  "when": "You need data from the backend and must confirm the exact endpoint, params, and response shape before writing an HttpClient service.",
  "prerequisites": [
    "The `rystad-api` MCP server is connected.",
    "You know the business domain you need (e.g. 'wells', 'production', 'companies')."
  ],
  "steps": [
    {
      "action": "List what backends exist so you target the right microservice.",
      "tools": [
        "list_microservices"
      ]
    },
    {
      "action": "Search for endpoints matching your domain keyword.",
      "tools": [
        "search_endpoints"
      ],
      "note": "Returns {service, method, path, summary}."
    },
    {
      "action": "Get the full contract for the chosen endpoint.",
      "tools": [
        "get_endpoint_details"
      ],
      "note": "This response schema is the ONLY allowed source for your TypeScript model interface."
    },
    {
      "action": "Confirm the endpoint exists before writing any code.",
      "tools": [
        "validate_endpoint"
      ],
      "note": "If invalid, STOP."
    },
    {
      "action": "Get the gateway proxy path + auth requirements for this project.",
      "tools": [
        "get_gateway_pattern",
        "get_auth_requirements"
      ],
      "note": "Use the returned apiRoute as your service base URL."
    }
  ],
  "filesToCreate": [],
  "validation": [
    "You can name the exact service, method, path, and every response field — each traceable to a tool call."
  ],
  "doneCriteria": [
    "Endpoint validated via `validate_endpoint`.",
    "Response schema captured for the model interface."
  ],
  "commonMistakes": [
    "Guessing a path from the domain name.",
    "Assuming params not in `get_endpoint_details`.",
    "Skipping `validate_endpoint`."
  ],
  "relatedRecipes": [
    "add-data-table"
  ]
}