Skip to content

About this practice

Status
draft
Endorsement
none yet
Last reviewed
2026-07-26

Best practice 2

Default to agent-accessibility; prioritise effort by demand and importance

Practice

The resources you use will support agents to different degrees, by design. If one you depend on is poorly supported, say so. Providers use demand to decide what to improve.

Make resources machine-actionable and discoverable by default, then set the level of support by type. Sort resources by how widely used and important they are, and invest accordingly. Keep a generic path for minor resources instead of building a custom interface for each. Govern access (authenticate and rate-shape where needed); a default of accessibility does not mean unmetered access.

Prioritisation is a funding decision. Back a scheme that ties interface investment to how used and important a resource is, and fund the top-tier interfaces as infrastructure. This keeps resources reachable by agents without an open-ended maintenance cost.

Reasons

Agents already reach resources whether or not they were built for them. Not planning for this does not stop it. It means agents use interfaces no one designed, with more load and worse results. Planning for it means agents can be steered to interfaces that work. Machine-actionability is not a new demand: it is the founding goal of the FAIR principles, which agents now make concrete. But a custom interface for every resource costs too much and is rarely worth it. Widely used and important resources are worth a proper interface. Minor resources can use a lighter, generic path. Sorting resources into types makes these choices clear. A default of accessibility is not a default of unlimited access. The Accessible principle (the A of FAIR) always allowed authentication. The load that automated clients now place on open resources makes governed access the realistic default.

Examples

  • The maintainer of a heavily-used database ships a first-party MCP server covering the queries people actually run, and links it from the documentation. Traffic that used to arrive as thousands of small REST calls now comes through one path the provider designed, and answers improve because the agent is no longer reverse-engineering the API.
  • With no first-party interface on offer, a scientist reaches a popular resource through a third-party MCP server they have not checked. It maps one field to the wrong column, the analysis runs on the wrong data, and the output looks plausible while being wrong. A vetted first-party path is what would have avoided the detour (checking a third-party tool before trusting it is BP08; vetting at connect time is BP03).
  • A team spends weeks building and maintaining a bespoke agent interface for a niche tool that one group runs twice a year. The same effort spent on a top-tier resource would have served far more people; the work did not follow demand.
  • A minor tool stays reachable through a shared registry's metadata instead of a bespoke interface, so an agent can still discover and call it. A registry such as bio.tools (life sciences) is one worked instance of this light generic path.
  • A provider sorts its resources into tiers by how widely used and important they are, funds the top tier as maintained infrastructure, and leaves minor resources on the generic path. The ELIXIR Core Data Resources (life sciences) are one such tier, selected on quantitative and qualitative indicators.
  • A resource keeps a default-open path but authenticates and rate-shapes automated traffic, so a burst of agent calls does not knock it over for its human users. Its logs cannot tell agents from people, which is why the limit is set at the resource rather than inferred from the client.

Sources

Change history

  • 2026-07-27: Renumbered from BP01 to BP02 on inserting the new BP01 (match the method to the task).
  • 2026-07-27: Rewrote Examples as concrete scenarios (actor, action, outcome), including anti-patterns, replacing restatements of the practice; kept the labelled life-science instances (Core Data Resources, bio.tools).
  • 2026-07-26: Rewritten to be domain-neutral (FAIR as the general anchor; ELIXIR and bio.tools demoted to labelled examples) and to replace "open to agents" with machine-actionable, discoverable, and governed-per-tier, grounded in FAIR and the COAR load survey.
  • 2026-07-25: Created from the ELIXIR TF distillation (hooks 2, 3).

Discussion