ed-mcp 0.0.0-stage → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Seth Osher
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,202 @@
1
+
2
+ Apache License
3
+ Version 2.0, January 2004
4
+ http://www.apache.org/licenses/
5
+
6
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7
+
8
+ 1. Definitions.
9
+
10
+ "License" shall mean the terms and conditions for use, reproduction,
11
+ and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by
14
+ the copyright owner that is granting the License.
15
+
16
+ "Legal Entity" shall mean the union of the acting entity and all
17
+ other entities that control, are controlled by, or are under common
18
+ control with that entity. For the purposes of this definition,
19
+ "control" means (i) the power, direct or indirect, to cause the
20
+ direction or management of such entity, whether by contract or
21
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
22
+ outstanding shares, or (iii) beneficial ownership of such entity.
23
+
24
+ "You" (or "Your") shall mean an individual or Legal Entity
25
+ exercising permissions granted by this License.
26
+
27
+ "Source" form shall mean the preferred form for making modifications,
28
+ including but not limited to software source code, documentation
29
+ source, and configuration files.
30
+
31
+ "Object" form shall mean any form resulting from mechanical
32
+ transformation or translation of a Source form, including but
33
+ not limited to compiled object code, generated documentation,
34
+ and conversions to other media types.
35
+
36
+ "Work" shall mean the work of authorship, whether in Source or
37
+ Object form, made available under the License, as indicated by a
38
+ copyright notice that is included in or attached to the work
39
+ (an example is provided in the Appendix below).
40
+
41
+ "Derivative Works" shall mean any work, whether in Source or Object
42
+ form, that is based on (or derived from) the Work and for which the
43
+ editorial revisions, annotations, elaborations, or other modifications
44
+ represent, as a whole, an original work of authorship. For the purposes
45
+ of this License, Derivative Works shall not include works that remain
46
+ separable from, or merely link (or bind by name) to the interfaces of,
47
+ the Work and Derivative Works thereof.
48
+
49
+ "Contribution" shall mean any work of authorship, including
50
+ the original version of the Work and any modifications or additions
51
+ to that Work or Derivative Works thereof, that is intentionally
52
+ submitted to Licensor for inclusion in the Work by the copyright owner
53
+ or by an individual or Legal Entity authorized to submit on behalf of
54
+ the copyright owner. For the purposes of this definition, "submitted"
55
+ means any form of electronic, verbal, or written communication sent
56
+ to the Licensor or its representatives, including but not limited to
57
+ communication on electronic mailing lists, source code control systems,
58
+ and issue tracking systems that are managed by, or on behalf of, the
59
+ Licensor for the purpose of discussing and improving the Work, but
60
+ excluding communication that is conspicuously marked or otherwise
61
+ designated in writing by the copyright owner as "Not a Contribution."
62
+
63
+ "Contributor" shall mean Licensor and any individual or Legal Entity
64
+ on behalf of whom a Contribution has been received by Licensor and
65
+ subsequently incorporated within the Work.
66
+
67
+ 2. Grant of Copyright License. Subject to the terms and conditions of
68
+ this License, each Contributor hereby grants to You a perpetual,
69
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70
+ copyright license to reproduce, prepare Derivative Works of,
71
+ publicly display, publicly perform, sublicense, and distribute the
72
+ Work and such Derivative Works in Source or Object form.
73
+
74
+ 3. Grant of Patent License. Subject to the terms and conditions of
75
+ this License, each Contributor hereby grants to You a perpetual,
76
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77
+ (except as stated in this section) patent license to make, have made,
78
+ use, offer to sell, sell, import, and otherwise transfer the Work,
79
+ where such license applies only to those patent claims licensable
80
+ by such Contributor that are necessarily infringed by their
81
+ Contribution(s) alone or by combination of their Contribution(s)
82
+ with the Work to which such Contribution(s) was submitted. If You
83
+ institute patent litigation against any entity (including a
84
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
85
+ or a Contribution incorporated within the Work constitutes direct
86
+ or contributory patent infringement, then any patent licenses
87
+ granted to You under this License for that Work shall terminate
88
+ as of the date such litigation is filed.
89
+
90
+ 4. Redistribution. You may reproduce and distribute copies of the
91
+ Work or Derivative Works thereof in any medium, with or without
92
+ modifications, and in Source or Object form, provided that You
93
+ meet the following conditions:
94
+
95
+ (a) You must give any other recipients of the Work or
96
+ Derivative Works a copy of this License; and
97
+
98
+ (b) You must cause any modified files to carry prominent notices
99
+ stating that You changed the files; and
100
+
101
+ (c) You must retain, in the Source form of any Derivative Works
102
+ that You distribute, all copyright, patent, trademark, and
103
+ attribution notices from the Source form of the Work,
104
+ excluding those notices that do not pertain to any part of
105
+ the Derivative Works; and
106
+
107
+ (d) If the Work includes a "NOTICE" text file as part of its
108
+ distribution, then any Derivative Works that You distribute must
109
+ include a readable copy of the attribution notices contained
110
+ within such NOTICE file, excluding those notices that do not
111
+ pertain to any part of the Derivative Works, in at least one
112
+ of the following places: within a NOTICE text file distributed
113
+ as part of the Derivative Works; within the Source form or
114
+ documentation, if provided along with the Derivative Works; or,
115
+ within a display generated by the Derivative Works, if and
116
+ wherever such third-party notices normally appear. The contents
117
+ of the NOTICE file are for informational purposes only and
118
+ do not modify the License. You may add Your own attribution
119
+ notices within Derivative Works that You distribute, alongside
120
+ or as an addendum to the NOTICE text from the Work, provided
121
+ that such additional attribution notices cannot be construed
122
+ as modifying the License.
123
+
124
+ You may add Your own copyright statement to Your modifications and
125
+ may provide additional or different license terms and conditions
126
+ for use, reproduction, or distribution of Your modifications, or
127
+ for any such Derivative Works as a whole, provided Your use,
128
+ reproduction, and distribution of the Work otherwise complies with
129
+ the conditions stated in this License.
130
+
131
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
132
+ any Contribution intentionally submitted for inclusion in the Work
133
+ by You to the Licensor shall be under the terms and conditions of
134
+ this License, without any additional terms or conditions.
135
+ Notwithstanding the above, nothing herein shall supersede or modify
136
+ the terms of any separate license agreement you may have executed
137
+ with Licensor regarding such Contributions.
138
+
139
+ 6. Trademarks. This License does not grant permission to use the trade
140
+ names, trademarks, service marks, or product names of the Licensor,
141
+ except as required for reasonable and customary use in describing the
142
+ origin of the Work and reproducing the content of the NOTICE file.
143
+
144
+ 7. Disclaimer of Warranty. Unless required by applicable law or
145
+ agreed to in writing, Licensor provides the Work (and each
146
+ Contributor provides its Contributions) on an "AS IS" BASIS,
147
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148
+ implied, including, without limitation, any warranties or conditions
149
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150
+ PARTICULAR PURPOSE. You are solely responsible for determining the
151
+ appropriateness of using or redistributing the Work and assume any
152
+ risks associated with Your exercise of permissions under this License.
153
+
154
+ 8. Limitation of Liability. In no event and under no legal theory,
155
+ whether in tort (including negligence), contract, or otherwise,
156
+ unless required by applicable law (such as deliberate and grossly
157
+ negligent acts) or agreed to in writing, shall any Contributor be
158
+ liable to You for damages, including any direct, indirect, special,
159
+ incidental, or consequential damages of any character arising as a
160
+ result of this License or out of the use or inability to use the
161
+ Work (including but not limited to damages for loss of goodwill,
162
+ work stoppage, computer failure or malfunction, or any and all
163
+ other commercial damages or losses), even if such Contributor
164
+ has been advised of the possibility of such damages.
165
+
166
+ 9. Accepting Warranty or Additional Liability. While redistributing
167
+ the Work or Derivative Works thereof, You may choose to offer,
168
+ and charge a fee for, acceptance of support, warranty, indemnity,
169
+ or other liability obligations and/or rights consistent with this
170
+ License. However, in accepting such obligations, You may act only
171
+ on Your own behalf and on Your sole responsibility, not on behalf
172
+ of any other Contributor, and only if You agree to indemnify,
173
+ defend, and hold each Contributor harmless for any liability
174
+ incurred by, or claims asserted against, such Contributor by reason
175
+ of your accepting any such warranty or additional liability.
176
+
177
+ END OF TERMS AND CONDITIONS
178
+
179
+ APPENDIX: How to apply the Apache License to your work.
180
+
181
+ To apply the Apache License to your work, attach the following
182
+ boilerplate notice, with the fields enclosed by brackets "[]"
183
+ replaced with your own identifying information. (Don't include
184
+ the brackets!) The text should be enclosed in the appropriate
185
+ comment syntax for the file format. We also recommend that a
186
+ file or class name and description of purpose be included on the
187
+ same "printed page" as the copyright notice for easier
188
+ identification within third-party archives.
189
+
190
+ Copyright [yyyy] [name of copyright owner]
191
+
192
+ Licensed under the Apache License, Version 2.0 (the "License");
193
+ you may not use this file except in compliance with the License.
194
+ You may obtain a copy of the License at
195
+
196
+ http://www.apache.org/licenses/LICENSE-2.0
197
+
198
+ Unless required by applicable law or agreed to in writing, software
199
+ distributed under the License is distributed on an "AS IS" BASIS,
200
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201
+ See the License for the specific language governing permissions and
202
+ limitations under the License.
package/NOTICE ADDED
@@ -0,0 +1,52 @@
1
+ ed-mcp
2
+ Copyright (c) 2026 Seth Osher. Licensed under the MIT License (see LICENSE).
3
+
4
+ src/catalog/data/engineers.json is derived from EliteDangerousCore
5
+ (https://github.com/EDDiscovery/EliteDangerousCore), Engineers.cs,
6
+ Copyright 2022-2024 EDDiscovery development team, licensed under the
7
+ Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0).
8
+ A copy of the licence is in LICENSES/Apache-2.0.txt.
9
+ The data was converted from C# to JSON.
10
+
11
+ test/fixtures/builds/coriolis-exports/ holds builds and statistics from the Coriolis
12
+ test fixtures (https://github.com/EDCD/coriolis, __tests__/fixtures/), Copyright (c)
13
+ 2015 Coriolis.io, Colin McLeod, licensed under the MIT License. They were cut down to the
14
+ components and statistics that the tests use.
15
+
16
+ The ship calculations in src/ships/ (mass, jump range, power, speed, shields, armour and
17
+ weapon damage) are ported from Coriolis (https://github.com/EDCD/coriolis),
18
+ src/app/shipyard/Calculations.js, Module.js, Ship.js, Constants.js and ModuleUtils.js, and
19
+ src/app/utils/JournalUtils.js and BlueprintFunctions.js. The Coriolis licence
20
+ (LICENSE.md) follows, verbatim:
21
+
22
+ All Data and [associated JSON](https://github.com/EDCD/coriolis-data) files are intellectual property and copyright of Frontier Developments plc ('Frontier', 'Frontier Developments') and are subject to their
23
+ [terms and conditions](https://www.frontierstore.net/terms-and-conditions/).
24
+
25
+ The code (Javascript, CSS, HTML, and SVG files only) specificially for Coriolis.io is released under the MIT License.
26
+
27
+ Copyright (c) 2015 Coriolis.io, Colin McLeod
28
+
29
+ Permission is hereby granted, free of charge, to any person obtaining a copy
30
+ of this software (Javascript, CSS, HTML, and SVG files only), and associated documentation files (the "Software"), to deal
31
+ in the Software without restriction, including without limitation the rights
32
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
33
+ copies of the Software, and to permit persons to whom the Software is
34
+ furnished to do so, subject to the following conditions:
35
+
36
+ The above copyright notice and this permission notice shall be included in
37
+ all copies or substantial portions of the Software.
38
+
39
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
40
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
41
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
42
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
43
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
44
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
45
+ THE SOFTWARE.
46
+
47
+ build_stats uses ship, module and blueprint data from coriolis-data
48
+ (https://github.com/EDCD/coriolis-data). ed-mcp downloads it at run time and does not
49
+ include it. The test fixtures in test/fixtures/builds/ hold small extracts of it.
50
+
51
+ Elite Dangerous game data is the intellectual property of Frontier Developments plc.
52
+ This project is not affiliated with Frontier Developments, Inara, EDSM, Spansh or EDCD.
package/README.md CHANGED
@@ -1,3 +1,187 @@
1
- # Temporary Holding Version
1
+ # ed-mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ ed-mcp connects Claude to Elite Dangerous. Claude can then read your commander data and plan with you.
4
+
5
+ With ed-mcp, Claude can:
6
+
7
+ - plan a ship build: the modules to buy, the engineering, the materials and the engineers to visit, and the route to all of them,
8
+ - model a ship build: jump range, power, defences and damage, and the effect of changes,
9
+ - work out which materials you are short of and the trades that cover them,
10
+ - find the best station for a module, ship or service, ranked by travel time and price,
11
+ - plan trade runs and loops, and find where to sell or buy a commodity,
12
+ - put the stops for your accepted missions in the best order,
13
+ - read your game journal for your location, ship, cargo, materials, missions and engineer progress.
14
+
15
+ ### Why use it
16
+
17
+ Inara, EDSM, Spansh, EDSY and the community wikis already have this data, and you can do all of this on their sites. ed-mcp does not replace them. It lets Claude use them together, with your game journal, in one conversation. Some commanders find it easier to ask a question in their own words than to use several sites.
18
+
19
+ ed-mcp runs on your computer. It keeps your plans and settings on your computer. It reads from Inara, EDSM, Frontier and Spansh, and it downloads game data from GitHub.
20
+
21
+ ed-mcp is not affiliated with Frontier Developments, Inara, EDSM or Spansh.
22
+
23
+ ## What you can ask
24
+
25
+ - "Here is my build from EDSY. Make a plan for the modules I need to buy or engineer. Tell me the materials I am short of and where to trade for them."
26
+ - "What jump range do I get if I fit a 5A FSD with grade 5 increased range?"
27
+ - "Where is the nearest Guardian technology broker?"
28
+ - "What do I need for grade 5 dirty drives?"
29
+ - "Find me a trade route from here. I have 400 t of cargo."
30
+ - "Where can I sell 200 t of gold near Atlas?"
31
+ - "Find me a trade loop from this station that I can run for an hour."
32
+ - "What does this station sell, and is anything cheap?"
33
+ - "Which modules can I buy at this outfitting?"
34
+ - "Plan the best order for my passenger missions."
35
+ - "Plan the route for my Corsair build plan."
36
+ - "From now on, ignore stations more than 2,000 ls from the star."
37
+
38
+ ## Install
39
+
40
+ ### Claude Desktop
41
+
42
+ 1. Download `ed-mcp-<version>.mcpb` from the [Releases](https://github.com/pilotso11/ed-mcp/releases) page.
43
+ 2. Open the file. Claude Desktop shows the ed-mcp settings form.
44
+ 3. Fill in the fields for the services that you use (see [Connect your accounts](#connect-your-accounts)). All fields are optional.
45
+
46
+ To make sure that the file came from this project, run the GitHub CLI command below. It shows that the ed-mcp release workflow built the file from this repository. This command works for version 0.1.1 and later.
47
+
48
+ ```bash
49
+ gh attestation verify ed-mcp-<version>.mcpb --repo pilotso11/ed-mcp
50
+ ```
51
+
52
+ ### Claude Code
53
+
54
+ Run this command. Put your own values in place of `<...>`:
55
+
56
+ ```bash
57
+ claude mcp add ed-mcp -s user \
58
+ -e INARA_API_KEY=<key> -e INARA_CMDR=<commander name> \
59
+ -e EDSM_API_KEY=<key> -e EDSM_CMDR=<commander name> \
60
+ -- npx -y ed-mcp
61
+ ```
62
+
63
+ - Keep `ed-mcp` directly after `add`. The `-e` options take every word after them until the `--`.
64
+ - Leave out the `-e` options for a service that you do not use.
65
+ - On a Mac, also add `-e ED_JOURNAL_DIR=<folder>` (see [Your game journal](#your-game-journal)).
66
+
67
+ Then start a new Claude Code session. To make sure that the server works, ask Claude "What is my journal status?".
68
+
69
+ ## Connect your accounts
70
+
71
+ Every account is optional. Without one, the tools for that service tell Claude which setting is missing. The game data, station search, route and plan tools work with no account.
72
+
73
+ | Service | What it gives Claude | What you need |
74
+ | -------- | -------------------------------------------------------- | -------------------------------------------------------------------- |
75
+ | Journal | Location, ship, cargo, materials, missions, engineers | The game journal folder (see below) |
76
+ | Inara | Ranks, squadron, main ship, community goals | Your API key (inara.cz, Settings, Inara API) and commander name |
77
+ | EDSM | Last known location, materials and cargo | Your API key (edsm.net, Settings, API Key) and commander name |
78
+ | Frontier | Current ship with engineering, location and fleet | A Frontier login in your browser. No key is necessary. |
79
+
80
+ To log in to Frontier, ask Claude "Log me in to Frontier". Claude gives you a link. Open the link and sign in. Then tell Claude that you are done. The login lasts 25 days. If you log in to ed-mcp on another computer, the old login ends.
81
+
82
+ The game journal is the best source for most questions. It is on your computer and it is current while you play. Inara and EDSM show data from your last sync to them.
83
+
84
+ ### All settings
85
+
86
+ | Setting | Meaning |
87
+ | ---------------- | --------------------------------------------------------------------------------------------------------- |
88
+ | `INARA_API_KEY` | Your Inara API key |
89
+ | `INARA_CMDR` | Your in-game commander name |
90
+ | `EDSM_API_KEY` | Your EDSM API key |
91
+ | `EDSM_CMDR` | Your commander name on EDSM |
92
+ | `ED_JOURNAL_DIR` | The game journal folder. On Windows, the default is the game's folder. Use a full path or one that starts with `~`. |
93
+ | `ED_MCP_PLANS` | A different file for your plans. Use a full path or one that starts with `~`. The default is `plans.json` in the settings folder (see [Your data](#your-data)). |
94
+
95
+ Inara needs both of its settings. EDSM needs both of its settings.
96
+
97
+ ## Your game journal
98
+
99
+ Elite Dangerous writes a journal while you play. ed-mcp reads it and never changes it.
100
+
101
+ **If Claude runs on your gaming PC**, ed-mcp finds the journal by itself. The folder is `%USERPROFILE%\Saved Games\Frontier Developments\Elite Dangerous`. If Windows moved your Saved Games folder (for example, into OneDrive), set `ED_JOURNAL_DIR` to the real folder.
102
+
103
+ **If Claude runs on a Mac**, copy the journal to the Mac with Syncthing:
104
+
105
+ 1. Install Syncthing on the PC and on the Mac (syncthing.net).
106
+ 2. On the PC, add the folder `%USERPROFILE%\Saved Games\Frontier Developments\Elite Dangerous`. Set the folder type to **Send Only**.
107
+ 3. Pair the two devices. Share the folder with the Mac.
108
+ 4. On the Mac, accept the folder into a local folder, for example `~/EliteDangerous`. Set the folder type to **Receive Only**.
109
+ 5. Set `ED_JOURNAL_DIR` to that folder. In Claude Desktop, use the Journal folder field.
110
+ 6. Ask Claude "What is my journal status?". While you play, the newest journal is a few minutes old.
111
+
112
+ Do not share `%LOCALAPPDATA%\Frontier Developments\Elite Dangerous`. That folder has the same name, but it holds only the game's settings. If you share it by mistake, the journal status tells you.
113
+
114
+ The game also writes `Market.json`, `Outfitting.json` and `Shipyard.json` to the same folder when you open those screens. ed-mcp reads them to show what the station you last opened sells, with current prices.
115
+
116
+ The journal tools warn you when the newest entry is more than 30 minutes old. Then the game is not running, or Syncthing has stopped.
117
+
118
+ ## Plans
119
+
120
+ Claude can save plans for you, for example a ship build with its modules, engineering and materials. Ask Claude to add items, mark them done, or export the plan as a Markdown file. To keep a plan in a project folder, export it as JSON and import it again later with `plan_import`. The plans stay on your computer, in `plans.json` in the settings folder (see [Your data](#your-data)). To keep them in another place, for example a folder that you back up, set `ED_MCP_PLANS`.
121
+
122
+ ## Preferences
123
+
124
+ ed-mcp ranks stations by travel time and price. Your preferences control which stations it uses. To change a preference, tell Claude, for example "Avoid surface stations" or "My time is worth 50M credits an hour". The change stays for future sessions. For one question only, say so: "Just this once, include fleet carriers."
125
+
126
+ | Preference | Default |
127
+ | -------------------------------- | -------------------------------------------------------------------------- |
128
+ | Distance from the star | Up to 1,000 ls. A station further out is used only when no other matches. |
129
+ | Surface stations | Avoided. They are used only when no orbital station matches. |
130
+ | Fleet carriers | Excluded |
131
+ | Megaships | Allowed |
132
+ | Landing pad size | Taken from your current ship |
133
+ | Permit-locked systems | Excluded, for example Sol. Tell Claude when you hold a permit. |
134
+ | Jump range | Taken from your current ship (85% of its best range) |
135
+ | Value of your time | 20M credits an hour |
136
+
137
+ The value of your time decides between a cheap station far away and a dearer one nearby. At 20M credits an hour, one extra minute of travel is worth about 333,000 credits.
138
+
139
+ The travel times come from about 1,300 timed trips in a commander's journals, flown with supercruise assist. If you fly faster, tell Claude "I fly about 40% faster in supercruise". For all the details, see the [tool reference](docs/tools.md#travel-model).
140
+
141
+ ## Limits
142
+
143
+ - Station, market and trade data come from Spansh. Market prices can be some hours or days old. The results show the age of each price. Spansh gets prices from EDDN, so a market that you open while you run a tool such as EDMC reaches Spansh within minutes.
144
+ - Trade routes and first-time mission routes can take a minute or more. If Spansh is still working, Claude asks again.
145
+ - Trade routes go one way. Trade loops use two or three stations and one commodity on each leg. Their scores use one price snapshot, and prices fall as you repeat a loop.
146
+ - ed-mcp cannot see the mission board. It plans routes only for missions that you accepted.
147
+ - Material plans ignore the storage limit for each material grade.
148
+
149
+ ## Your data
150
+
151
+ ed-mcp keeps these files on your computer:
152
+
153
+ | Data | File |
154
+ | ---------------------------- | -------------------------------------------- |
155
+ | Plans | `plans.json`, or the file in `ED_MCP_PLANS` |
156
+ | Preferences | `preferences.json` |
157
+ | Frontier login | `capi-token.json`, readable only by you |
158
+ | Game data and cached results | The cache folder |
159
+
160
+ The files are in these folders:
161
+
162
+ | System | Settings folder | Cache folder |
163
+ | ------- | ------------------------------ | ---------------------------------- |
164
+ | macOS | `~/Library/Preferences/ed-mcp` | `~/Library/Caches/ed-mcp` |
165
+ | Windows | `%APPDATA%\ed-mcp\Config` | `%LOCALAPPDATA%\ed-mcp\Cache` |
166
+ | Linux | `~/.config/ed-mcp` | `~/.cache/ed-mcp` |
167
+
168
+ ed-mcp sends your API keys only to the service that they belong to. On first use, it downloads game data from the coriolis-data and FDevIDs projects on GitHub: modules, blueprints and materials, and the ship and module data for build statistics. Then it looks for new versions once a week. To get new data at once, ask Claude to refresh the game data.
169
+
170
+ ## More information
171
+
172
+ - [Tool reference](docs/tools.md): what each tool does, its inputs and its results.
173
+ - [Contributing](CONTRIBUTING.md): development, releases and service registrations.
174
+
175
+ ## Acknowledgements
176
+
177
+ - **Coriolis** ([coriolis.io](https://coriolis.io), [GitHub](https://github.com/EDCD/coriolis)): `build_stats` ports the Coriolis ship calculations for jump range, power, speed, shields, armour and weapon damage. The Coriolis test builds check our results. Thank you to Colin McLeod and the Coriolis contributors. The Coriolis code is MIT licensed. `NOTICE` holds its licence, and we credit it here too.
178
+ - **coriolis-data** ([EDCD](https://github.com/EDCD/coriolis-data)): the ship, module and blueprint data. ed-mcp downloads it at run time. The data is the intellectual property of Frontier Developments.
179
+ - **EDCD FDevIDs** ([GitHub](https://github.com/EDCD/FDevIDs)): the material and outfitting names.
180
+ - **EliteDangerousCore** ([EDDiscovery](https://github.com/EDDiscovery/EliteDangerousCore)): the engineer table, under the Apache-2.0 licence (see `NOTICE`).
181
+ - **Spansh, Inara and EDSM**: the services that ed-mcp reads from.
182
+ - **The Elite Dangerous community wikis** (Alioth): the material trader rules.
183
+ - **Elite Dangerous** is a trademark of Frontier Developments plc. ed-mcp is not affiliated with Frontier Developments.
184
+
185
+ ## Licence
186
+
187
+ MIT. See `NOTICE` for third-party data.