How to Use San José planning permit search in opencode
Returns San José planning-permit records covering site development, conditional uses, adjustments, and tree removals. Use it to research recent land-use decisions at a business location or compare planning activity across ZIP codes.
Prompts to try with San José planning permit search in opencode
Copy an example into opencode, or ask in your own words.
Use San José planning permit search to find recent planning records for ZIP code 95113 and add a table of the returned project details to this project's research page.
Use San José planning permit search for 1123 Coleman Avenue, San José, and create a Markdown brief from any matching planning records.
Use San José planning permit search to find records matching Eden Housing and add the published project details to our housing research dataset.
Use San José planning permit search to compare ZIP codes 95113 and 95131 over the last 30 days, then build a comparison table in this project.
Use San José planning permit search for planning records on Coleman Avenue and create a report that separates conditional-use activity from other planning results.
How to set up San José planning permit search in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run San José planning permit search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "data-sanjoseca-gov/planning-permits/search_planning_permits", "input": { "zip": "<zip>" } }'
Then paste one of the prompts above: opencode finds San José planning permit search on Spiral, shows the price and runs it.
San José planning permit search providers and prices
Spiral runs San José planning permit search through Alexandria. Open a card for today's price, with every fee included.
$0.00873 per call.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Sort | issued_desc or issued_asc | issued_desc | issued_desc: newest issued first; issued_asc: oldest first. |
| Limit | 1 to 100 | 25 | Rows per page. |
| Period | any, last_30_days, or days_60_to_180 | any | Which published list to read: any (default, both in one request), last_30_days or days_60_to_180. |
Every API field of San José Open Data: building and planning permits (data.sanjoseca.gov) · Search planning permits is on its tool page: open its card above.
What can you do with San José planning permit search in opencode?
Build a San José planning-activity table for a commercial-site research project. A coding agent can turn returned records into project data and separate site development, conditional-use, adjustment, and tree-removal results.
Business-site planning review
Collect matching planning records for a commercial address and summarize the land-use decisions relevant to a site review.
Local development brief
Turn recent planning results for a San José ZIP code into a short editorial brief organized by permit type.
Affordable-housing project research
Find published planning activity associated with Eden Housing and summarize the matching projects for a housing research brief.
Commercial development comparison
Compare matching planning activity across selected San José ZIP codes using the same published issuance window.
Conditional-use research
Review conditional-use records in a commercial area to identify examples for further planning research.
Planning-record digest
Compare repeated searches for a business district and report newly observed records without labeling them as newly changed city records.
More on San José planning permit search and opencode
Overview
San José planning permit search in other agents
Questions about San José planning permit search in opencode
Can opencode use San José planning permit search?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run San José planning permit search like any built-in tool.
How much does San José planning permit search cost in opencode?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need an Alexandria account to use San José planning permit search in opencode?
No. Spiral runs San José planning permit search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up San José planning permit search in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while San José planning permit search runs?
San José planning permit search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.
Does this cover all of Santa Clara County?
The documented source is the City of San José's permit collection. It does not establish coverage for other Santa Clara County jurisdictions.
How often is the permit data refreshed?
The provider documents daily reloads of the city datasets. That is the published refresh cadence, rather than a promise of immediate updates after a city decision.
How far back does planning-permit coverage go?
The documented issuance windows are the last 30 days and days 60–180. Their stated boundaries leave days 31–59 between them, so they should not be treated as a continuous six-month history.
Which kinds of planning permits are covered?
The provider specifically lists site development, conditional use, adjustments, and tree removals. The search concerns planning activity in San José.
Can I tell exactly when an individual record changed?
The published lists have no per-record update timestamp. A daily reload therefore does not identify which individual planning records changed that day.
Start using San José planning permit search in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


