agenttoolworks-com API

openapi: 3.1.0
info:
  title: agenttoolworks-com API
  version: '2026-10-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-29: 2 operation(s) read from 10 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; agenttoolworks-com has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 1
    pages-with-code: 10
    pages-read: 10
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-29'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://agenttoolworks.com/use-cases/remote-jobs-api
  - https://agenttoolworks.com/use-cases/validate-iban-api
  - https://agenttoolworks.com/use-cases/greenhouse-job-board-api
  - https://agenttoolworks.com/use-cases/verify-eu-vat-number-api
  - https://agenttoolworks.com/use-cases/french-company-lookup-siren-api
  - https://agenttoolworks.com/use-cases/job-postings-api-greenhouse-lever
  - https://agenttoolworks.com/use-cases/sanctions-screening-api-for-ai-agents
  - https://agenttoolworks.com/use-cases/track-company-hiring
  - https://agenttoolworks.com/use-cases/new-job-postings-feed
  - https://agenttoolworks.com/use-cases/supplier-onboarding-kyb-agent
servers:
- url: https://verifydesk.agenttoolworks.com
paths:
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://agenttoolworks.com/use-cases/remote-jobs-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: httpie
        snippet: HTTP https://jobsradar.agenttoolworks.com/mcp Connect it, Claude Code claude mcp add --transport http jobsradar \
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: Remote jobs API for agents, straight from company boards
      description: Calls the JobsRadar remote jobs tool via a single HTTP request.
      x-source: https://agenttoolworks.com/use-cases/remote-jobs-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostMcpResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostMcpRequest:
      type: object
      properties:
        name:
          type: string
          description: The tool name to invoke, e.g., "search_jobs".
        arguments:
          type: object
          description: Arguments for the tool call.
        arguments.title_keywords:
          type: array
          description: List of keywords to match job titles.
        arguments.remote_only:
          type: boolean
          description: If true, only return postings the board marks as remote.
        arguments.limit:
          type: integer
          description: Maximum number of job postings to return.
      required:
      - name
      - arguments
    PostMcpResponse:
      type: object
      properties:
        count:
          type: integer
          description: Number of job postings returned.
        data_as_of:
          type: string
          description: Timestamp of the data snapshot.
        boards_searched:
          type: integer
          description: Number of boards searched in the call.
        boards_live:
          type: integer
          description: Number of boards currently live.
        boards_failed:
          type: array
          description: List of boards that failed to respond.
        boards_truncated:
          type: array
          description: Boards where results were truncated.
        postings_seen:
          type: integer
          description: Total postings seen across all boards.
        duplicates_removed:
          type: integer
          description: Number of duplicate postings removed.
        jobs:
          type: array
          description: Array of job posting objects.
        jobs.id:
          type: string
          description: Unique identifier of the job posting.
        jobs.title:
          type: string
          description: Job title.
        jobs.company:
          type: string
          description: Company name.
        jobs.location:
          type: string
          description: Location string of the job.
        jobs.remote:
          type: boolean
          description: Whether the posting is marked as remote.
        jobs.postedAt:
          type: string
          description: Timestamp when the job was posted.
        jobs.applyUrl:
          type: string
          description: Direct URL to apply for the job.
        jobs.provider:
          type: string
          description: Source provider of the posting.
  securitySchemes:
    API_key:
      type: http
      scheme: bearer
      x-source: https://agenttoolworks.com/use-cases/supplier-onboarding-kyb-agent
tags:
- name: Mcp
security:
- API_key: []