{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"smithery_adzuna-adzuna-mcp","slug":"adzuna-adzuna-mcp","name":"adzuna-mcp","type":"mcp","url":"https://smithery.ai/servers/adzuna/adzuna-mcp","page_url":"https://unfragile.ai/adzuna-adzuna-mcp","categories":["mcp-servers"],"tags":["mcp","model-context-protocol","smithery:adzuna/adzuna-mcp"],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"smithery_adzuna-adzuna-mcp__cap_0","uri":"capability://tool.use.integration.job.search.query.execution.via.mcp","name":"job-search-query-execution-via-mcp","description":"Executes structured job search queries against the Adzuna job board API through MCP protocol bindings, translating natural language or structured parameters (location, keyword, salary range, job type) into HTTP requests to Adzuna's REST endpoints and returning paginated job listings with standardized schema. Implements MCP resource and tool abstractions to expose Adzuna's search, filtering, and pagination capabilities as composable protocol operations that Claude and other MCP clients can invoke without direct API knowledge.","intents":["I want to search for jobs matching specific criteria (location, salary, job type) and get results back in a structured format","I need to integrate job search capabilities into an AI agent without managing API credentials or HTTP details","I want to paginate through large job result sets and filter by multiple dimensions simultaneously"],"best_for":["AI agent builders creating job search workflows","LLM application developers needing job data integration without API boilerplate","Teams building recruitment or career-planning assistants"],"limitations":["Rate limiting depends on Adzuna API tier — free tier typically allows 100-1000 requests/day","Search results limited to Adzuna's job board coverage (primarily UK, US, Canada, Australia, India)","No real-time job posting updates — data freshness depends on Adzuna's crawl frequency (typically 24-48 hours)","Pagination offset-based rather than cursor-based, limiting deep result set traversal efficiency"],"requires":["Adzuna API key (free tier available at adzuna.com/api)","MCP client compatible with tool/resource protocol (Claude 3.5+, or custom MCP client)","Network connectivity to Adzuna API endpoints"],"input_types":["structured parameters (location string, keyword string, salary_min/max integers, job_type enum)","pagination parameters (page number, results per page)"],"output_types":["JSON job listings with fields: job_id, title, company, location, salary_min, salary_max, description, url, posting_date","metadata: total_results, current_page, pages_available"],"categories":["tool-use-integration","search-retrieval"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_1","uri":"capability://search.retrieval.multi.parameter.job.filtering.with.location.awareness","name":"multi-parameter-job-filtering-with-location-awareness","description":"Supports filtering job results across multiple dimensions (keyword, location, salary range, job type, company) with geographic awareness, translating human-readable location names into Adzuna's location taxonomy and applying server-side filtering to reduce result set size before returning to client. Uses Adzuna's API query parameters to push filtering logic to the backend, minimizing data transfer and enabling efficient result ranking by relevance and salary.","intents":["I want to find remote or work-from-home jobs in a specific region","I need to filter jobs by salary range and exclude certain job types","I want to search for jobs at specific companies or in specific industries"],"best_for":["Job seekers building personalized search agents","Recruitment platforms integrating Adzuna data with custom filtering UX","Career coaches automating job matching for clients"],"limitations":["Location filtering depends on Adzuna's predefined location taxonomy — custom geographic boundaries not supported","Salary filtering applies only to jobs with salary data populated (coverage varies by region, typically 30-60%)","No boolean query syntax — cannot combine filters with AND/OR/NOT logic, only simple parameter matching","Job type taxonomy limited to Adzuna's predefined categories (full-time, part-time, contract, temporary, etc.)"],"requires":["Adzuna API key","MCP client with tool invocation support","Knowledge of Adzuna's location codes or ability to map user input to location taxonomy"],"input_types":["keyword string","location string (city, region, or country code)","salary_min, salary_max (integers, currency assumed from location)","job_type enum (full_time, part_time, contract, temporary, graduate, permanent)","company name (optional, string)"],"output_types":["filtered JSON job listings","result count and pagination metadata"],"categories":["search-retrieval","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_2","uri":"capability://search.retrieval.job.listing.detail.retrieval.with.full.metadata","name":"job-listing-detail-retrieval-with-full-metadata","description":"Fetches complete job posting details for a specific job ID, including full description, company information, salary details, application URL, and posting metadata (date posted, last updated). Implements single-job lookup via Adzuna's job detail endpoint, providing rich context for downstream processing (summarization, matching, application automation) without requiring additional web scraping or external data enrichment.","intents":["I want to get the full job description and details for a specific job posting","I need to extract structured data from a job posting (salary, requirements, benefits) for analysis","I want to build a job recommendation system that scores jobs based on full posting content"],"best_for":["Job matching and recommendation engines","Resume-to-job alignment analysis tools","Job posting aggregation and comparison platforms"],"limitations":["Requires valid job_id from a prior search — cannot look up jobs by external identifiers (LinkedIn ID, Indeed ID, etc.)","Job descriptions are HTML-formatted and may contain embedded formatting, links, or images requiring client-side parsing","No historical versioning — cannot retrieve previous versions of a job posting if it was updated","Job details may become stale if posting is removed from Adzuna's index (no guaranteed retention period)"],"requires":["Adzuna API key","Valid job_id from a prior search query","MCP client with tool invocation support"],"input_types":["job_id (string, from search results)"],"output_types":["JSON job detail object with fields: job_id, title, company, location, salary_min, salary_max, salary_currency, description (HTML), company_logo_url, redirect_url, posting_date, last_updated, job_type, category"],"categories":["search-retrieval","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_3","uri":"capability://tool.use.integration.mcp.protocol.resource.exposure.for.job.data","name":"mcp-protocol-resource-exposure-for-job-data","description":"Exposes Adzuna job search and detail operations as MCP resources and tools, allowing Claude and other MCP clients to discover and invoke job search capabilities through the MCP protocol's resource listing and tool calling mechanisms. Implements MCP server-side schema definitions for job search parameters and results, enabling type-safe tool invocation and automatic parameter validation before API calls.","intents":["I want Claude to automatically discover and use job search capabilities without me writing custom tool definitions","I need type-safe job search invocations with automatic parameter validation","I want to compose job search with other MCP tools in a multi-tool agent workflow"],"best_for":["Claude users building job search agents via MCP","MCP server developers integrating Adzuna data into larger tool ecosystems","Teams standardizing on MCP for LLM tool integration"],"limitations":["MCP protocol overhead adds ~50-200ms latency per tool invocation compared to direct API calls","Tool schema complexity may limit Claude's ability to compose multiple job search operations in a single agent step","MCP resource discovery requires client support — older LLM clients may not expose resource listing","No built-in caching — repeated identical searches result in duplicate API calls unless client implements caching layer"],"requires":["MCP-compatible client (Claude 3.5+, or custom MCP client implementation)","MCP server running adzuna-mcp (local or remote)","Network connectivity between MCP client and server"],"input_types":["MCP tool invocation with structured parameters"],"output_types":["MCP tool result with JSON job data","MCP resource listing with job search tool schemas"],"categories":["tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_4","uri":"capability://search.retrieval.pagination.and.result.set.navigation","name":"pagination-and-result-set-navigation","description":"Supports paginated navigation through large job result sets using offset-based pagination (page number and results per page), returning metadata about total results, current page, and available pages to enable efficient result set traversal. Implements pagination parameters in search queries, allowing clients to iterate through results without loading entire result sets into memory.","intents":["I want to iterate through all job results matching a search query without loading everything at once","I need to know how many total results match my search and how many pages are available","I want to implement a paginated UI or API that shows job results 10-50 at a time"],"best_for":["Job search UIs with pagination controls","Batch job processing workflows that iterate through large result sets","Job aggregation services that need to fetch all results matching a query"],"limitations":["Offset-based pagination becomes inefficient for deep result sets (page 100+) due to database offset overhead","No cursor-based pagination — cannot efficiently resume from a specific result if result set changes between requests","Maximum page depth may be limited by Adzuna API (typically 100-500 pages depending on tier)","Results per page limited to Adzuna's maximum (typically 50-100 results per page)"],"requires":["Adzuna API key","MCP client with tool invocation support","Knowledge of pagination parameters (page number, results_per_page)"],"input_types":["page number (integer, 1-indexed)","results_per_page (integer, typically 10-50)"],"output_types":["JSON job listings array","pagination metadata: total_results, current_page, pages_available, results_per_page"],"categories":["search-retrieval","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_5","uri":"capability://tool.use.integration.error.handling.and.api.failure.recovery","name":"error-handling-and-api-failure-recovery","description":"Implements error handling for Adzuna API failures (rate limits, network errors, invalid parameters) at the MCP layer, translating API errors into structured error responses that LLM agents can interpret and act upon. Includes retry logic with exponential backoff for transient failures and clear error messages for invalid search parameters.","intents":["I want my agent to gracefully handle API rate limits and retry failed searches","I need clear error messages when a job search fails so I can adjust parameters","I want my application to recover automatically from temporary network failures"],"best_for":["Robust LLM agents that need to handle API failures gracefully","Production job search applications with high availability requirements","Teams building resilient multi-step workflows that depend on job search"],"limitations":["Retry logic only handles transient failures; permanent API errors (invalid credentials) not retried","Exponential backoff may delay responses for rate-limited requests","Error messages depend on Adzuna API documentation; some error codes may be ambiguous","No circuit breaker pattern; repeated failures to Adzuna API not automatically bypassed"],"requires":["Adzuna API credentials","MCP server with error handling and retry logic implemented"],"input_types":["job search queries (any valid parameters)"],"output_types":["structured error responses with error code, message, and suggested remediation","retry metadata (retry count, backoff delay)"],"categories":["tool-use-integration","safety-moderation"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"smithery_adzuna-adzuna-mcp__cap_6","uri":"capability://data.processing.analysis.job.result.normalization.and.schema.mapping","name":"job-result-normalization-and-schema-mapping","description":"Normalizes Adzuna API job results into a standardized schema that abstracts away API-specific field names and data types, ensuring consistent result structure across different Adzuna API versions or regional variants. Implements field mapping logic that translates Adzuna's raw response format into canonical job object schema with consistent field names, types, and optional fields.","intents":["I want job results in a consistent format regardless of which Adzuna API endpoint I query","I need to map Adzuna job fields to my application's internal job schema","I want to handle optional fields gracefully without null-checking in my agent code"],"best_for":["Applications that need to abstract away Adzuna API schema details","Multi-provider job search systems that need consistent result formats","Teams building job data pipelines that depend on stable field names"],"limitations":["Schema normalization may lose Adzuna-specific fields not in the canonical schema","Field mapping is static; dynamic field addition requires server code changes","Some Adzuna fields may be missing in certain regions; normalized schema uses null/default values","No schema versioning; breaking schema changes require client updates"],"requires":["Adzuna API credentials","MCP server with schema normalization logic implemented"],"input_types":["raw Adzuna API job results"],"output_types":["normalized job objects with standardized field names and types","schema metadata (required fields, optional fields, field types)"],"categories":["data-processing-analysis","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":25,"verified":false,"data_access_risk":"high","permissions":["Adzuna API key (free tier available at adzuna.com/api)","MCP client compatible with tool/resource protocol (Claude 3.5+, or custom MCP client)","Network connectivity to Adzuna API endpoints","Adzuna API key","MCP client with tool invocation support","Knowledge of Adzuna's location codes or ability to map user input to location taxonomy","Valid job_id from a prior search query","MCP-compatible client (Claude 3.5+, or custom MCP client implementation)","MCP server running adzuna-mcp (local or remote)","Network connectivity between MCP client and server"],"failure_modes":["Rate limiting depends on Adzuna API tier — free tier typically allows 100-1000 requests/day","Search results limited to Adzuna's job board coverage (primarily UK, US, Canada, Australia, India)","No real-time job posting updates — data freshness depends on Adzuna's crawl frequency (typically 24-48 hours)","Pagination offset-based rather than cursor-based, limiting deep result set traversal efficiency","Location filtering depends on Adzuna's predefined location taxonomy — custom geographic boundaries not supported","Salary filtering applies only to jobs with salary data populated (coverage varies by region, typically 30-60%)","No boolean query syntax — cannot combine filters with AND/OR/NOT logic, only simple parameter matching","Job type taxonomy limited to Adzuna's predefined categories (full-time, part-time, contract, temporary, etc.)","Requires valid job_id from a prior search — cannot look up jobs by external identifiers (LinkedIn ID, Indeed ID, etc.)","Job descriptions are HTML-formatted and may contain embedded formatting, links, or images requiring client-side parsing","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.24,"ecosystem":0.38999999999999996,"match_graph":0.25,"freshness":0.5,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-05-24T12:16:25.062Z","last_scraped_at":"2026-05-03T15:19:34.639Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=adzuna-adzuna-mcp","compare_url":"https://unfragile.ai/compare?artifact=adzuna-adzuna-mcp"}},"signature":"5QS4Sc+VhclIiQv3EiRHI6jndXnYGu01tzjzRPfpJX0Zs8+aeNQ1lqalMTKUYf+JjOXtKLByczW5wniJ0dfSCQ==","signedAt":"2026-06-20T16:21:04.380Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/adzuna-adzuna-mcp","artifact":"https://unfragile.ai/adzuna-adzuna-mcp","verify":"https://unfragile.ai/api/v1/verify?slug=adzuna-adzuna-mcp","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}