> ## Documentation Index
> Fetch the complete documentation index at: https://docs.askgina.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Verify and fix a Spot MCP connection

## Smoke Test

1. Confirm the URL is exactly `https://askgina.ai/ai/spot/mcp`.
2. Complete OAuth and approve write access.
3. Run `tools/list`; compare the returned native tools with the [tool reference](https://docs.askgina.ai/spot-mcp/features.md).
4. Call `getSimplePrice` directly.
5. Call `{ "command": "echo ok" }` to verify `bash`.
6. Call `{ "command": "host-tools --name getSimplePrice --limit 5 --full" }` to verify the matching sandbox allowlist.

## Common Issues

### Access is denied after sign-in

Spot MCP is rollout-controlled by one global database flag. A true `mcp_spot_enabled` row enables every authenticated account; a false or missing row denies every account. Admin status and non-production environments do not bypass it. Ask an operator to enable the global row rather than changing an individual account.

### An old Gina token fails

This is expected. `/ai/gina/mcp` is read-only and old execute grants are not migrated. Remove the old connection, add the Spot URL, and complete OAuth again.

### A host tool is missing

Check [Features and Allowlist](https://docs.askgina.ai/spot-mcp/features.md). Predictions, Perps, dashboard rendering, and condition-specific scheduling tools are intentionally excluded.

`webSearch` and `fetchUrl` are also excluded. Use your MCP client's native web tools.

### A write input fails

Read the native tool's published input schema, or run `host-tools schema <toolName>` inside `bash`. Re-check the asset, chain, amount, destination, and transaction details before requesting a new quote. First reconcile any submitted or uncertain operation.

## LP positions or quotes

### Positions are missing, partial or stale

Check the delegated wallet and network, then refresh. Read discovery coverage and follow inventory
cursors; a partial page or provider failure is not an empty wallet. Unavailable economics should
not erase a discovered position or be displayed as zero. Cached inventory is not a fresh quote.

### Solana reports insufficient funds

Check both pool tokens and SOL for network fees and account creation. A quoted WSOL wrap consumes
SOL too. Settle preparatory swaps before obtaining a fresh LP quote.

### A quote expired or admission changed

Read the current allowlist revision and resolve the refusal. Re-quote an unexecuted intent using
its `intentId`; the new quote supersedes the old `quoteId`. If a send is outstanding, reconcile it
first. Never execute a superseded quote.

### A pool or token is unsupported

Use the full resolved pool identity and correct protocol. A candidate result is not admission.
Live Token-2022 transfer-hook programs and unsupported v4 hooks can prevent LP operations even
when swaps work. Preserve the refusal and choose a supported operation or pool; do not keep
resubmitting the same unsupported request.

### A send is pending, partial or unknown

Use `getLpOperationStatus` or `getSolanaLpOperationStatus`. Keep the original operation ID; if it
was lost, use `unresolved: true` and paginate. Missing receipts and timeouts do not authorize
another send. Follow [LP recovery](https://docs.askgina.ai/spot-mcp/liquidity-positions.md#recover-an-uncertain-operation).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.