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.
| Account | An Elixir account that an administrator has approved |
|---|---|
| Anonymous access | None |
| Open to every signed-in account | 2: list_capabilities and list_material_sources |
| Charged tools | 3: compute_pourbaix_stability, count_materials and search_materials |
| Daily allowance | 200 charged calls per day |
| Allowance window | one calendar day; the refusal message states when it resets |
| Most rows in one response | 50 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.
| Limit | Value | Unit | What it bounds |
|---|---|---|---|
| Rows per response | 50 | rows | Most 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 hops | 3 | hops | Furthest a knowledge-graph neighbour walk goes. It bounds the work, not the size of the answer. |
| Charged calls per day | 200 | charged calls per day | The 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 set | 20 | rows | Rows 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 name | 8 | candidates | Most candidates listed when a name fits several materials. |
| Histogram bins | 20 | bins | Equal-width bins between the 1st and 99th percentile in a distribution; one open-ended bin is added at each end. |
| Longest graph path | 6 | edges | Longest path graph_shortest_path looks for. |
| Longest search scan | 45 | seconds | Wall-clock ceiling on one search scan. A search that outruns it is stopped. |
| Threshold | Value | Unit | What it does |
|---|---|---|---|
| Semi-metal band-gap ceiling | 0.1 | eV | Band gaps above zero and below this are classed semi-metal. |
| Semiconductor band-gap ceiling | 3 | eV | Band 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_materialsandsearch_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?