Skip to main content
Chemia Discovery
Browse the documentation

Access and limits

Access needs an Elixir account that an administrator has approved; there is no anonymous access. Your account decides which of the 28 tools you see. Charged tools draw on a daily allowance, and every response is capped at 50 rows.

At a glance
AccountAn Elixir account that an administrator has approved
Anonymous accessNone
Open to every signed-in account2: list_capabilities and list_material_sources
Charged tools3: compute_pourbaix_stability, count_materials and search_materials
Daily allowance200 charged calls per day
Allowance windowone calendar day; the refusal message states when it resets
Most rows in one response50 rows

Who can use the connector, and how do I get access?

Only people with an Elixir account that an administrator has approved can use the connector. Signing in is the only way in; there is no anonymous access.

To ask for an account, open the Elixir sign-in page and use its sign-up option. An administrator approves each account.

Your account decides which tools you see. These tools are open to every signed-in account: list_capabilities and list_material_sources. A tool your account is not entitled to is left out of your client's tool list.

Which datasets can I read?

The connector serves more than one dataset. Call list_material_sources for the current list: each entry has an id, a description, and whether the dataset is restricted.

From that tool's reading notes: restricted means reading the dataset needs full-dataset access. is_default marks the dataset a search would use for you when neither a source_id nor the query text names one, so it can differ between accounts. specialized marks a slice of the full catalogue chosen by application.

Some datasets, such as the full catalogue, are restricted to accounts with the matching access. The same tool shows which datasets your account can read.

A dataset id the server does not recognise raises no error, so check which dataset answered. Why did a tool answer from the trial subset instead of the dataset I asked for?

What are the limits?

These are the limits the server applies.

Response and work limits
LimitValueUnitWhat it bounds
Rows per response50rowsMost rows or items any single tool response returns. A tool result is pasted into the model's context, so this is a context-budget guard and not a database limit.
Knowledge-graph hops3hopsFurthest a knowledge-graph neighbour walk goes. It bounds the work, not the size of the answer.
Charged calls per day200charged calls per dayThe daily allowance for the tools marked charged, per caller. Tools that are not charged keep working when it is spent.
Rows on the first page of a refined or re-ranked set20rowsRows on the first page of a result set built by refine_result_set or rerank_result_set, which bounds the rows those tools can return.
Candidates listed for an ambiguous name8candidatesMost candidates listed when a name fits several materials.
Histogram bins20binsEqual-width bins between the 1st and 99th percentile in a distribution; one open-ended bin is added at each end.
Longest graph path6edgesLongest path graph_shortest_path looks for.
Longest search scan45secondsWall-clock ceiling on one search scan. A search that outruns it is stopped.
Classification thresholds
ThresholdValueUnitWhat it does
Semi-metal band-gap ceiling0.1eVBand gaps above zero and below this are classed semi-metal.
Semiconductor band-gap ceiling3eVBand gaps from the semi-metal limit up to this are classed semiconductor; larger gaps are insulators.

Which calls use the daily allowance?

  • Charged tools: compute_pourbaix_stability, count_materials and search_materials.
  • Allowance: 200 charged calls per day.
  • Scope: per caller account; separate from the web app allowance.
  • Refund: a reply that is a clarification question is refunded.

A charged call uses one unit of the allowance before the tool runs. Tools that are not charged never count against it.

When does the allowance reset, and what happens when it runs out?

The window is one calendar day; the refusal message states when it resets.

When the allowance is spent, the charged tools are refused with a message that gives the reset time. Tools that are not charged keep working.

If you hit the limit, see I reached the daily limit. What now?